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Avant-propos 

La collection Atelier du webmaster s'adresse aux personnes initiees au developpement de 
sites web qui souhaitent decouvrir et mettre en pratique les nouvelles technologies 
Internet. Sans negliger les aspects theoriques, nous donnons toujours priorite a la pratique 
afin que vous puissiez rapidement etre autonome. 

A travers les differents titres de cette collection vous decouvrirez les technologies qui font 
le web 2.0 et feront ce que certains nomment deja le web 3.0. 

Conventions typographiques 

Ann de faciliter la comprehension des techniques decrites, nous avons adopte les 
conventions typographiques suivantes : 

gras : menu, commande, boite de dialogue, bouton, onglet. 

italique : zone de texte, liste deroulante, case a cocher, bouton radio. 

Police baton : instruction, listing, texte a saisir. 

: dans les scripts, indique un retour a la ligne volontaire du aux contraintes de la 
mise en page. 

CD 

II s'agit d'informations complementaires relatives au sujet traite. Propose conseils et trues pratiques. 



Mise en garde sur un point important a ne pas negliger. 
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Preface 



Bonjour et merci pour l'investissement que vous venez d'effectuer. Vous allez decouvrir 
dans cet ouvrage certaines extensions de PHP5 dont on parle beaucoup, mais qui sont tres 
peu utilisees. Vous allez decouvrir egalement des extensions internes a PHP construites en 
C et compilees arm d'etre integrees dans le moteur de PHP (Zend). L'avantage de ces 
extensions par rapport aux bibliotheques programmers en PHP (PEAR par exemple) est 
leur rapidite. Elles ne seront pas toutes traitees en un seul ouvrage, le manuel PHP en 
repertoriant, a l'heure ou ces lignes sont ecrites, cent quatre-vingt cinq. Le choix a ete 
porte uniquement sur celles documentees dans le manuel officiel de PHP. Cette decision 
tient au fait que nous pensons qu'il est beaucoup plus important et utile d'enseigner a 
quelqu'un a cuisiner plutot que de le nourrir toute sa vie. Vous allez done decouvrir 
beaucoup de cas pratiques et assez peu de theorie, celle-ci etant deja publiee sur des 
millions de pages web et dans une innombrable quantite de livres. 

Cet ouvrage est divise en chapitres qui contiennent chacun un theme et plusieurs sections. 
Certains chapitres sont tres courts et d'autres beaucoup plus longs. La raison en est que 
certaines extensions comme BZIP2 ne comportent qu'une dizaine de fonctions et aucune 
constante predefinie ni directive de configuration a placer dans le fichier php.ini, et que 
d'autres extensions contiennent plus d'une centaine de fonctions ainsi qu'un grand 
nombre de constantes et des directives de configuration. 

Pour certains chapitres, il y a un cas pratique, presente en fin de chapitre, et celui-ci est 
parfois experimente selon plusieurs methodes afin de laisser au lecteur le choix pour 
integrer une methode plus qu'une autre dans un projet. Le cas pratique a pour objectif de 
vous fournir un exemple utilisable a l'interieur d'un cas reel, et done concret : site 
Internet, applications Intranet/extranet ; et cela en utilisant ces fameuses extensions qui 
sont (trop ?) souvent omises. C'est-a-dire que vous pouvez recuperer le code et le 
copier/coller. Vous devrez probablement aussi le modifier quelque peu, pour l'utiliser 
dans un (ou plusieurs) de vos projets. 

Le chapitre 1 montre l'interet de compresser des fichiers contenant du texte avec 
l'extension BZIP2 afin de gagner de la place sur le disque dur et d'utiliser ZIP pour placer 
des fichiers dans une archive, toujours dans l'objectif de gagner de l'espace disque. 
L'extension ZLIB sera egalement decrite en fin de ce chapitre, juste avant le cas pratique. 

Le chapitre 2 prouve que PHP n'est pas en reste en ce qui concerne la communication 
avec des logiciels de bureautique tels Word, Excel et les equivalents OpenOffice.org. 
Nous vous expliquerons comment creer une feuille Microsoft Excel contenant un 
graphique trouvant ses donnees dans une base MySQL, ainsi qu'une methode, certes 
empirique mais extremement efficace, pour interpreter des macros Visual Basic en PHP. 
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Nous vous presenterons egalement DOM, puissante extension gerant le XML, dans le but 
de creer des documents OpenOffice.org. 

Le chapitre 3, quant a lui, vous explique comment manipuler les images et vous permettra 
de prendre conscience des fonctions tres puissantes qu'offre PHP dans ce domaine avec 
la possibility de creer des dessins complexes. 

Le chapitre 4 est consacre a la generation des fichiers PDF : textes dynamiques ou 
statiques, images, signets... En somme, une petite boite a outils pour les documents 
destines a vos utilisateurs. 

Le chapitre 5 est une decouverte du monde LDAP et de ses avantages et inconvenients 
par rapport a une base de donnees. 

Le chapitre 6 aborde justement le domaine BDD (Bases de donnees) avec PDO {PHP 
Data Object) qui permet avec les memes fonctions de se connecter a n'importe quel 
SGBDR (Systeme de gestion de base de donnees) : MySQL, PostgreSQL, Oracle, etc. 

Le chapitre 7 decrit les fonctions des extensions Classkit et Runkit. Vous apprendrez 
comment ecrire du code dynamique et l'interet de le faire. 

Le chapitre 8 poussera un peu plus loin avec Ref 1 ecti on qui est une exception a la regie. 
Reflection n'est pas une extension interne a PHP mais une API {Application 
Programming Interface). 

Le chapitre 9 se consacre au systeme de cache et vous montrera comment accelerer 
l'affichage de pages dynamiques tout en soulageant votre serveur. 

Le chapitre 10 montre comment creer du code illisible humainement puisque compile. 
C'est l'extension Bcompiler qui s'en charge, le tout pour proteger vos algorithmes. 

Le chapitre 11 decrit une methode pour etudier une nouvelle extension encore non 
acquise. Vous comprendrez comment les auteurs de ce livre s'y prennent pour etudier et 
assimiler une extension non encore documented. 

II ne vous reste plus qu'a tourner les pages, et faire ainsi un magnifique voyage dans le 
monde des extensions internes a PHP. Nous vous souhaitons de faire des decouvertes 
enrichissantes dans ce domaine. 

Objectifs du livre 

Ce livre a pour objectif de vous eclairer sur les extensions de PHP tres peu usitees. Ces 
extensions nous ont pourtant ete tres utiles lors de la creation de certains projets effectues 
dans un passe plus ou moins lointain. Pour decouvrir ces extensions et les maitriser 
toutes, il nous a fallu du temps. Beaucoup de temps. Et aussi des plantages. Enormement 
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de plantages. II est dit que c'est la meilleure facon de progresses Sans compter le temps 
que nous avons passe a chercher les informations pour, a la fois trouver les bonnes 
extensions et les documentations. Le temps, c'est ce que, par le biais de cet ouvrage, nous 
desirons vous faire economises Nous le faisons aussi dans l'esprit PHP qui est de fournir 
nos decouvertes sans rien cacher. Vous permettre de gagner du temps, de 1' argent et des 
efforts parfois inutiles pour trouver des informations qui, au bout du compte, ne sont pas 
celles dont vous avez besoin. 

Nous vous conseillons de considerer ce livre comme un dictionnaire. Dans un 
dictionnaire, vous cherchez un mot precis. Dans ce livre, c'est la meme chose au niveau 
des informations. Vous desirez une information sur la compression de fichiers ? 
Rendez-vous au chapitre 1. Vous desirez utiliser l'API de reflexion ? Allez jeter un ceil au 
chapitre 8. Vous voulez savoir comment faire pour trouver les informations et comment 
on etudie une nouvelle extension afin de la maitriser ? Vous decouvrirez tout dans le 
chapitre Methodologie. Consultez directement le chapitre consacre au sujet qui vous 
interesse. Vous desirez retrouver un cas pratique afin de 1' adapter a l'un de vos projets, 
allez-y, ces exemples sont totalement libres de droits et nous y tenons. Vous desirez nous 
poser des questions, ecrivez-nous, nos adresses e-mail sont a votre disposition (dans la 
section A propos des auteurs de cette preface), ainsi, bien stir, que nos oreilles. 

Tels sont les objectifs de ce livre. Et s'il vous manque des informations, si vous auriez 
redige telle ou telle section autrement, ou si encore vous avez le moindre argument a 
formuler, n'hesitez pas a nous le faire savoir ! 

A qui s'adresse ce livre ? 

En voila une drole de question ! Un livre sur les extensions de PHP ne peut s'adresser 
qu'aux developpeurs PHP. Cela semble logique et d'une evidence certaine ? Rien n'est 
moins stir : quels developpeurs PHP ? Les bons, les tres bons, les debutants ? On ne peut 
pas dire qu'un certain niveau soit requis, car un developpeur debutant pourra trouver son 
compte dans ce livre, pourvu qu'il sache ce qu'est une fonction ou une boucle 
conditionnelle. Le developpeur confirme, lui, trouvera des explications claires et rapides 
sur des extensions que nous avons selectionnees car elles nous ont permis de repondre a 
de nombreux problemes. Le principal interet est que cela se traduira par un inevitable 
gain de temps dans la realisation de vos projets. 

Finalement, ce livre s'adresse a ceux qui veulent en connaitre plus sur PHP comme a ceux 
qui ont une problematique precise et qu'une extension du langage PHP pourrait resoudre. 
II peut etre vu comme "une formation a l'utilisation des extensions", car il offre des 
connaissances sur les principales extensions de PHP, puis propose des methodologies 
permettant d'apprehender de nouvelles extensions par soi-meme et d'elargir encore son 
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savoir et ses competences. Ce livre peut egalement etre utilise comme un dictionnaire, et 
permettre a chacun de prendre ici et la des morceaux de codes, et la comprehension qui 
va avec, afin d'enrichir considerablement ses propres realisations et/ou celles des autres. 

A propos des auteurs 
David Drapeau 

Developpeur autodidacte au parcours atypique et eclectique (manutentionnaire, musicien, 
magasinier, hypnotherapeute, formateur en informatique et en communication...), David 
Drapeau est tombe dans l'univers de la programmation quand il etait petit. Aujourd'hui, 
il se consacre entierement a PHP5 et attend avec impatience PHP6 dont il teste deja les 
nouveautes depuis le mois d' aotit 2007. II etudie egalement, pendant son temps libre, tout 
ce qui peut entrer en interaction avec PHP tels OpenLaszlo, AJAX et tout ce qui touche 
de pres ou de loin le domaine Internet : webmarketing, securite informatique, 
algorithmes. II est egalement passionne par les mathematiques qu'il pratique pour 
s'amuser quand il lui reste un peu de temps libre. 

Pour le joindre : da vi d . drapeau@gmai 1 . com 

Frederic Suire 

Frederic Suire s'est interesse des son plus jeune age, tout comme David Drapeau, au 
monde de la programmation. II a lui aussi suivi un parcours atypique, passant d' etudes 
litteraires a des etudes scientifiques, d'etudes musicales a des etudes artistiques. 
Aujourd'hui, il est developpeur web independant et maitrise, plus par passion que par 
necessite, un grand nombre de langages destines a l'lnternet (du HTML au PHP, du 
JavaScript a 1'ActionScript, et bien d'autres encore). Par la meme, peu de logiciels de 
graphisme lui sont inconnus. Son cheval de bataille favori ? Le developpement 
d'interfaces homme-machine, ou il peut s'amuser aussi bien graphiquement qu'en 
programmation. 

Pour le joindre : frederi c@sui re. i nfo 
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Compresser, 
c'est gagner... 



I est assez frequent de reprendre des projets qui 
possedent une partie de I'application qui comprend la 
gestion des fichiers. Et ces fichiers sont bien souvent, pour 
ne pas dire tout le temps, au format texte [.txt], PDF (.pcf/), 
et meme au format Excel [.xls). C'est Id tout I'interet des 
algorithmes de compression. 



Compresser, c'est gagner.. 



1.1 BZIP2 : compresser des donnees 

Evidemment, ces fichiers prennent enormement de place sur le serveur (le hardware) et 
tout le monde n'a pas les moyens de se payer un serveur dedie. Pourtant, certains sites 
amateurs sont tres bien fournis au niveau du contenu avec des liens internes vers des 
fichiers .pdf ou .xls pour des graphiques et des tableaux. 

Aujourd'hui, de tres nombreux formats de compression existent : .zip, -tar, .gz, -tgz, .rar, 
.bz2, .ace et bien d'autres encore. Dans ce chapitre, vous allez decouvrir trois formats 
compiles dans PHP : BZIP2, ZIP et ZLIB. Leurs avantages : puisque programmes en C et 
compiles avec PHP, il en ressort une grande rapidite d'execution. En premier lieu, nous 
allons vous decrire BZIP2 qui permet de compresser des donnees en quelques lignes de 
code et d'y acceder de nouveau ulterieurement tout aussi rapidement. Puis suivra ZIP, la 
plus consequente des trois extensions PHP etudiees dans ce chapitre. ZIP contient 
beaucoup de constantes predefmies (plus d'une quarantaine) et de fonctions (environ une 
quarantaine). ZLIB completera ce chapitre avec 1' etude de toutes ses fonctions. 

Comme c'est en forgeant qu'on devient forgeron, vous ne trouverez que tres peu de 
theorie. Beaucoup de sites Internet s'en chargent. Tout au long de ce livre, vous trouverez 
peu de discours et beaucoup de code. 

BZIP2 est une extension interne a PHP (programmee en C done) qui utilise la 
bibliotheque creee par Julian Seward et qui a vu le jour au milieu des annees 90. Cette 
bibliotheque cree des fichiers compresses a partir de l'algorithme de Burrows-Wheeler 
associe au codage de Huffman : l'extension des fichiers crees est .bz2. 

(J) Tous les exemples verifies et testes 

Tous les programmes presentes dans ce livre ont ete testes avec XAMPP 1 .6.2 sur Windows XP avec 
XAMPP installe dans C:\Program Files\. 



Creation d'un document 
Ouverture 

La premiere fonction a utiliser pour creer le premier document BZIP est celle d'ouverture 
d'un nchier .bz2 en mode Ecriture. Pour faire cela, c'est la fonction bzopen() qui s'y 
prete. 

I resource bzopen(chai ne $nom_fichier, chaine $mode_ouverture) 
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$mode_ouverture doit avoir pour valeur r (lecture) ou w (ecriture). Dans le cas du mode 
Ecriture, si le fichier n'existe pas, il est cree. 

<?php // Debut du script creer bzip2.php 
// On ouvre un fichier nomme exemple . bzip2 
$bzo = bzopen ( ' . / f ichiers/exemple . bz2 ' , "w"); 

Fermeture 

Puis, comme pour les fichiers texte, le fichier est ferme grace a la fonction bzclose(). 
int bzcl ose(resource $bzo) 

Le parametre $bzo est l'identifiant de connexion defini lors de l'appel de la fonction 
bzopen(). 

BZ_creer.php 

// On ferme le fichier bzip2 

$bzc = bzclose ( $bzo ) ; 

?> 

Lors de l'execution du script BZ_creer.php par le biais de votre navigateur favori, le script 
PHP va creer un fichier nomme exemple. bz2. 

Compression 

Les fonctions indispensables a tous les fichiers, ouverture et fermeture, ont ete etudiees. 
Entrons maintenant dans le vif du sujet avec l'etude de la fonction de compression 
bzcompress(). 

mixte bzcompress(chaine $donnees [, entier $taux_compression [, entier 
$f acteur_de_travai 1 ] ] ) 

bzcompressO compresse la chaine $donnees et retourne les donnees encodees ou un 
numero d'erreur en cas d'echec lors de la procedure de compression. Le taux de 
compression est affecte au parametre $taux_compression qui possede une valeur qui peut 
varier de 1 a 9. 9 represente le meilleur taux de compression mais s'avere un peu plus lent 
que 1 qui a par contre un petit taux de compression. $facteur_de_travai 1 controle le 
comportement de la compression. Sa valeur par defaut est 34 et est une valeur speciale. 
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Compresser, c'est gagner.. 



fl^ BZ_compression.php 

<?php 

$texte =«<lecontenuduf ichier 

Placez ici un texte de plus d' une dizaine de lignes afin de mieux vous 

rendre compte de la compression, 
lecontenuduf ichier ; 

// Le texte brut 
echo $texte . '<br/>'; 

// Le texte compresse 
$bzcomp = bzcompress ($texte) ; 
echo $bzcomp; 

?> 

| Fig. 1.1: 

BZh41AY&SYV-???— €@?@@?"#0 ?1@D ?Ee&8 $rE8PV- Resultat dans le 

navigateur de 

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^""^ retou r_bzcom press, php 

Decompression 

Decompresser des donnees BZIP2 est d'une simplicite enfantine. II suffit simplement de 
faire appel a la fonction bzdecompress () dont la syntaxe est la suivante : 

mixed bzdecompress (chai ne $donnees_compressees [, entier $small]) 

La fonction bzdecompress () decompresse les donnees $donnees_compresses qui ont ete 
compressees avec la fonction bzcompress (). 

$smal 1 permet de choisir entre le mode par defaut (si $smal 1 = f al se) ou un autre mode 
(si $ small = true) de decompression qui prend peu de memoire mais est plus lent a 
1' execution. 

(D Documentation officielle 

Vous pouvez vous referer d la documentation officielle en anglais d I'adresse suivante : 
http://www.bzip.Org/l.0.3/bzip2-manual-l.0.3.html. 
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Ecriture 

Cependant, bzcompress() n'ecrit pas les donnees compressees dans le fichier .bz2. La 
fonction donne juste un apercu des donnees telles qu'elles seront integrees dans le fichier 
compresse. II est temps maintenant de voir comment inserer les donnees dans le fichier 
exemple.bz2. Pour effectuer cette manipulation, l'utilisation de la fonction bzwrite() 
s'avere necessaire. 

entier bzwri te(resource $bzo, chaine $donnees [, entier $nb_caract_max] ) ecrit 
dans le fichier $bzo les donnees $donnees dont il est possible d'imposer une limite de 
caracteres grace au parametre optionnel $nb_caract_max. L'utilisation de la fonction 
bzwri te() est visible dans le script suivant : 

BZ_ecriture.php 

<?php 

/ / Ouverture 

$bzo = bzopen ( ' . / f ichiers/exemple . bz2 ' , "w"); 

$texte =«<lecontenuduf ichier 
lecontenuduf ichier ; 

// Ecriture dans le fichier compresse 

// int bzwrite ( resource bz, string data [, int length] ) 
bzwrite ( $bzo, $texte, strlen ($texte) ) ; 

$bzc = bzclose ( $bzo ) ; 
?> 

Lecture 

Gagner de la place est une chose et acceder de nouveau a des donnees en est une autre. 
Pourquoi gagner de la place s'il faut ensuite un grand nombre de lignes de code pour 
acceder a nouveau aux donnees ? Eh bien, c'est tout aussi simple de lire des donnees pour 
un fichier compresse en .bz2 qu'en Jxt. 

Pour la lecture d'un fichier compresse en .bz2, la responsabilite en revient a la fonction 
bzread(). 

chaine bzread (resource $bzo[, entier $nb_caract_max] ) 
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BZjecture.php 

<?php 

$file = " . /f ichiers/dynamisez_php . bz2 " ; 

$bzo = bzopen ($file, "r") or die (" Impossible d' ouvrir le fichier $file"); 

$decompresser fichier = ' ' ; 
while (! feof ($bzo) ) { 

$decompresser fichier .= bzread($bzo, f ilesize ( $ f ile ) ) ; 

} 

bzclose ( $bzo ) ; 

echo "Le contenu du fichier $file est : <br />\n"; 

echo stripslashes ( $decompresser fichier); 

?> 

Pour l'instant, les donnees affichees sont toujours compressees et leur lecture est 
incomprehensible pour un esprit normalement constitue. II est done necessaire de 
decompresser les donnees afin de rendre la lecture comprehensible a tout un chacun. 

Pour cela, il suffit juste de modifier la ligne : 

echo stripslashes ( $decompresser fichier); 

Et de proceder de la facon suivante : 

echo stripslashes (bzdecompress ( $decompresser fichier)); 

1 Maintenant, dans le meme repertoire fichiers, creez un fichier dynamisez_php. txt et 
faites un copier/coller du texte original (non compresse) dans ce fichier texte. Nous 
insistons sur le fait qu'il s'agit d'un copier/coller pour etre certain que le contenu soit 
identique afin de rendre credible la demonstration. Vous vous retrouvez done dans le 
repertoire fichiers avec dynamisez.jphp.hz2 et dynamisez_php.txt. 

2 Placez le curseur de la souris sur le fichier .bz2 et regardez sa taille (en octets) puis 
faites de meme sur le fichier .txt. Vous pouvez voir qu'avec si peu de contenu, il y 
a deja une difference assez nette entre les deux fichiers, le fichier compresse etant 
bien entendu le plus leger. Imaginez maintenant la difference de taille par rapport a 
un fichier .txt de plusieurs Ko et ce pour un repertoire de plusieurs dizaines, voire 
centaines de fichiers. Vous visualisez le gain d'espace disque economise sur le 
serveur ? Voici la difference que cela donne sur le poste suivant : 



so 
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dynamisez_php. txt 
Document texte 
1 Ko 



Type : Archive WinRAR 

Date de modification : 09/09/2007 09:50 

Taille : 4G5 octets 



Fig. 1.2: 

La taille du fichier 
compresse 




dynamisez_php.bz2 
Archive WinRAR 
1 Ko 



1 Ti 



dvnamisez_php. txl 
Document texte 



Type : Document texte 
Date de modification : 10/09/2007 09:00 
Taille : 503 octets 



Fig. 1.3: 

La taille du fichier texte 



Gestion des erreurs 

bzerror/ bzerrno/bzerrstr 

tableau bzerror(resource $bz) 
entier bzerrno(resource $bz) 
chaine bzerrstr(resource $bz) 

La fonction bzerror () retourne un tableau qui contient a la fois le numero et le message 
d'erreur. Les noms des cles sont errno pour le numero d'erreur et errstr pour le 
message d'erreur. 

Les fonctions bzerrno() et bzerrstr() retournent respectivement le numero et le 
message d'erreur sans avoir a utiliser la fonction bzerror () : 

BZ_bzerror.php 

<?php 

$file = " . /f ichiers/dynamisez_php . bz2 " ; 
$bzo = bzopen ($f ile, "r"); 

if ( ! bzwrite ( $bzo , "ecriture impossible en mode lecture"))! 
$bze = bzerror ( $bzo ) ; 

echo ' <pre>' ; 
print r ( $bze ) ; 
echo ' </pre>' ; 



bzclose ($bzo) ; 
?> 
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Vous pouvez recuperer les memes informations par les cles errno et errstr de la maniere 
suivante : 

BZ_errno_errstr.php 

<?php 

$file = " . /f ichiers/dynamisez_php ,bz2 " ; 
$bzo = bzopen ($f ile, "r"); 

if ( ! bzwrite ( $bzo, "ecriture impossible en mode lecture"))! 
$bze = bzerror ( $bzo) ; 

echo $bze [' errno' ] .'<br/>'. $bze [' errstr '] ; 

} 

bzclose ( $bzo ) ; 
?> 

La troisieme methode utilise les fonctions bzerrno() et bzerror() comme le montre le 
script bzerrno_bz.errorstr.php : 



BZ_bzerrno_bzerrstr.php 

<?php 

$file = " . /f ichiers/dynamisez_php . bz2 " ; 
$bzo = bzopen ($f ile, "r") ; 

if (! bzwrite ( $bzo , "ecriture impossible en mode lecture"))! 
$bzerrno = bzerrno ($bzo) ; 
$bzerrstr = bzerrstr ($bzo) ; 

echo $bzerrno .'<br/>'. $bzerrstr; 

} 

bzclose ($bzo) ; 
?> 

Vous pouvez vous apercevoir qu'il est tres facile de gerer des fichiers compresses a l'aide 
de la bibliotheque BZIP2. Cependant, ce n'est pas la seule bibliotheque disponible pour 
PHP dont 1' extension est programmee en C. II en existe une autre qui contient plus de 
fonctions, et qui est par logique plus complete et plus complexe : il s'agit de ZIP. C'est 
1' extension la plus connue et la plus utilisee. Peut-etre aussi la plus ancienne. Nous allons 
etudier cette extension et decouvrir ce qu'elle contient de plus par rapport a BZIP2. 
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1 .2 ZIP : creer des archives 

Tout d'abord, un peu d'histoire. Le format de compression ZIP a ete cree a la fin des 
annees 80 par Phil Katz. Pendant des annees, le format ZIP s'est impose comme un 
standard de compression. Ce qui etait normal, vu qu'il n'y avait pas de concurrence a 
l'epoque. Puis, sont venus tellement de formats de compression qu'il est difficile de ne 
pas en oublier un seul. Creer un fichier ZIP par le biais de PHP est tres simple. 

La premiere difference entre BZIP2 et ZIP est que BZIP2 permet de compresser du 
contenu textuel, c'est-a-dire des donnees, alors que ZIP permet de creer une archive (un 
dossier compresse en quelque sorte) et d'y placer des fichiers, des repertoires. L' autre 
grande difference est que ZIP fonctionne en version objet. 

Compression 

Voici un exemple tres simple de la creation d'une archive dans laquelle deux fichiers 
crees precedemment avec BZIP2, dynamisez_php.bz2 et dynamisez_php.txt, vont etre 
inseres. Le programme est tres court et, chose courante en PHP, il est tres simple : 

^ ZA_addFile.php 

<?php 

// On cree une instance de la classe ZipArchive 
$zip = new ZipArchive () ; 

// On cree une archive ZIP 

// si elle n'existe pas, on la cree (ZIPARCHIVE :: CREATE) 
if ( $zip->open (' ./fichiers/ exemple .zip' , 

ZIPARCHIVE: : CREATE) === TRUE) { 

// On y insere le fichier dynamisez php.txt 
$zip->addFile ( ' . / fichiers/ dynamisez_php . txt' , 
'dynamisez php.txt'); 

// ainsi que le fichier exemple. bz2 
// que l'on renomme php dynamique . bz2 
$zip->addFile (' ./fichiers/ dynamisez_php . bz2 ' , 
' php_dynamique . bz2 ' ) ; 

// Et on ferme le fichier 
$zip->close ( ) ; 

// Et voila, c'est aussi simple que cela. 
echo 'ok' ; 
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} else { 

echo ' echec' ; 

} 

?> 

Voici la syntaxe des fonctions utilisees : 

mixte ZipArchi ve: :open(chaTne nom_f i chi er [, entier drapeaux]) 

bool ZipArchive: : addFi 1 e(chaTne $nom_fi chier[, chaTne $nom_dans_archi ve] ) 

bool ZipArchive: :close(void) 

Explications 

La premiere fonction utilisee est open(). Nous y reviendrons plus loin. La seconde 
fonction utilisee est add Fi 1 e () qui va ajouter un fichier dans 1' archive ZIP. Le premier 
parametre, $nom_f i chi er, represente le nom du fichier existant, c'est-a-dire celui que Ton 
veut inserer dans l'archive. Le second parametre, $nom_l ocal , est optionnel. II permet de 
renommer un nchier afin que son nom dans l'archive soit different du nom du nchier 
recupere en premier argument. Vous en avez un exemple lors de la deuxieme utilisation 
de la fonction addFi 1 e () dans le script creer_zip.php. 

Revenons maintenant a la fonction open (). Tout comme la fonction fopen() pour les 
fichiers texte, elle prend en premier argument le nom du nchier (archive ZIP) a ouvrir, ici 
exemple.zip. Le second argument est nouveau par rapport a la fonction open() des 
fichiers. II s'agit de flags (drapeaux). En fait, ce sont des constantes qui possedent une 
valeur numerique. Les constantes admises pour cette fonction sont les suivantes : 

ZipArchive: :CREATE : cree l'archive si elle n'existe pas. 
ZipArchive: :EXCL : genere une erreur si l'archive existe deja. 
I Zi pArchi ve: :CHECKCONS : effectue des analyses supplementaires de consistances et 
emet une erreur si elles echouent. 

ZipArchive: :OVERWRITE : cree l'archive si elle n'existe pas et l'ecrase si elle existe 
deja. 

ZipArchive: :open() retourne une valeur mixed. II s'agit aussi de constantes dont une est 
booleenne (TRUE en cas de succes) et les autres sont de type int (les messages d'erreurs 
possibles en cas d'echec) : 

ZipArchive: :ER_EXISTS : erreur generee si le fichier existe deja. 
ZipArchive: :ER_INC0NS : archive ZIP inconsistante. 
ZipArchive: :ER_INVAL : argument invalide. 
■ Zi pArchi ve: : ER_MEM0RY : echec d'allocation memoire. 
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ZipArchive: :ER_NOENT : erreur generee si le fichier n'existe pas. 
I ZipArchive: :ER_NOZIP : erreur generee s'il ne s'agit pas d'une archive ZIP. 

ZipArchive: :ER_OPEN : erreur generee s'il est impossible d'ouvrir le fichier. 

ZipArchive: :ER_READ : erreur de lecture. 
■ ZipArchive: :ER_SEEK : erreur de pointeur. 

Les erreurs 

L'extension ZIPpossede des constantes predefinies dont certaines sont destinees a gerer 
les erreurs. Le script nomme retour_open.php tente d'ouvrir une archive ZIP en generant 
volontairement une erreur. L' erreur generee est recuperee grace a un switch-case qui 
prend en compte toutes les constantes de retour listees precedemment et permet de 
prendre connaissance du message d'erreur retourne lors de l'execution du fichier PHP 
dans le navigateur. Le code donne done : 

^ ZA_retour_open.php 

<?php 

$zip = new ZipArchive () ; 

$zo = $z ip->open ( ' . /f ichiers/exemple . zip' , ZipArchive :: EXCL) ; 
if ($zo ! == true) { 
switch ( $zo) { 

case ZipArchive: :ER_EXISTS: 

echo ' le fichier existe deja'; 
break; 

case ZipArchive: :ER_INCONS : 

echo 'archive ZIP inconsistante' ; 
break; 

case ZipArchive :: ER_INVAL : 
echo 'argument invalide' ; 
break; 

case ZipArchive: :ER_MEMORY: 

echo 'echec allocation memoire' ; 
break; 

case ZipArchive: :ER_NOENT: 
echo 'fichier inexistant' ; 
break; 

case ZipArchive: :ER_NOZIP: 

echo 'non reconnue comme archive ZIP'; 
break; 

case ZipArchive: :ER_OPEN: 

echo ' ouverture fichier impossible'; 
break; 
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case ZipArchive: :ER_READ: 

echo 'argument de lecture'; 
break; 

case ZipArchive: :ER_SEEK: 

echo 'erreur de pointeur' ; 

break; 
default : 

echo 'erreur incomprehensible'; 

} 

} 

/ / $zip->close ( ) ; 
?> 

Le flag ZipArchive: :EXCL signifie que Ton veut ouvrir un fichier qui n'existe pas deja, 
done on veut en creer un nouveau. Ainsi, si le fichier que Ton essaie d'ouvrir existe, cela 
genere le message d'erreur suivant : 

Le fichier existe deja. 

Ce qui correspond a la valeur de retour ZipArchive: :ER_EXISTS. 

Appelons maintenant un fichier qui n'existe pas et voyons ce que cela donne : 

Ouverture fichier impossible. 

Ce qui correspond a la valeur de retour ZipArchive: :ER_0PEN. 

L'erreur retournee n'est pas seulement due au flag mais aussi au premier argument. 

Appelez, avec le premier argument, le fichier exemple.bzip2 et placez le flag 
ZipArchive: :CREATE ou ZipArchive: :CHECKCONS en second argument. L'erreur retournee 
est ZipArchive: :ER_N0ZIP. 

A present, remplacez CREATE par EXCL et cette fois l'erreur retournee est 
ZipArchive: :ER_EXISTS. 

Decompression 

La decompression d'une archive peut s'effectuer de plusieurs facons. La methode decrite 
dans cette section est l'utilisation de la fonction extracTo(). 

mixte ZipArchive: :extractTo(cha!ne $rep_dest[, mixte $entrees]) 

$rep_dest est le repertoire dans lequel les fichiers extraits seront inseres. $entrees s'ecrit 
sous forme de table si vous desirez extraire seulement quelques fichiers de 1' archive. Ce 
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second parametre etant optionnel, ne le renseignez pas si vous desirez extraire la totalite du 
contenu de 1' archive. Le script ZA_extractTo.php extrait les fichiers texte3.txt et texte4.txt 
de 1' archive et les place dans le repertoire textes. Si ce repertoire n'existe pas, il sera cree. 

Un exemple d 'utilisation est donne dans la section Fonctions utiles - Extraire des 
fichiers d'une archive. 

Fonctions utiles 

Aj outer des fichiers crees en temps reel 

Vous avez vu comment inserer des fichiers existants dans une archive. Aussi, ZIP permet 
d'inserer des fichiers encore non existants et qui vont etre crees en temps reel. Cela 
permet de mieux dynamiser PHP en gerant par exemple un systeme de fichiers de logs 
(gestion des erreurs et exceptions) qui seront automatiquement compresses dans une 
archive. Le script ZA_addFromString.php cree une archive ZIP qui contient plusieurs 
fichiers . txt : 

ZA_addFromString.php 

<?php 

$oZA = new ZipArchive ( ) ; 

$open = $oZA->open ( ' . /f ichiers/addFromString. zip' , ZIPARCHIVE :: CREATE) ; 
if ($open) { 

echo "creation de 1' archive et insertion des fichiers texte 

grace a la fonction addFromString ( ) . . . " ; 
$oZA->addFromString ( ' textel . txt' , ' Le premier texte ajoute grace a 

la fonction addFromString ()') ; 
$oZA->addFromString ( ' texte2 . txt' , ' Le deuxieme texte ajoute 

grace a la fonction addFromString ()') ; 
$oZA->addFromString ( ' texte3 . txt' , ' Le troisieme texte ajoute 

grace a la fonction addFromString ()') ; 
$oZA->addFromString ( ' texte4 . txt' , ' Le quatrieme texte ajoute 

grace a la fonction addFromString ()') ; 
echo 'ok<br/>'; 

$oZA->close ( ) ; 
} else { 

echo ' echec' ; 

} 

?> 
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Apres avoir execute le fichier addFromString.php, une archive a ete creee dans le 
repertoire courant. Elle contient quatre fichiers texte nommes textel.txt, texte2.txt, 
texte3.txt et texte4.txt. 



m 



fonctions.zip - WinRAR (Version devaluation) 



Fichier Commandes Outils Favoris Options Aide 



Ajouter Extraire vers Tester Voir Suppression Rechercher Assistant Info 



m 

Antivirus 



[2 i |§ fonctions.zip - ZIP archive, la taille non compressee est de 239 octets 



Horn O 

111 textel.txt 
(3 texte2.txt 
(3 texte3.txt 
(3 texte4.txt 



Taille | Compresse | Type 



I Modifie le 



~] CRC32 I 



59 
58 
G1 
G1 



G1 Document texte 

GO Document texte 

G2 Document texte 

G2 Document texte 



Total 239 octets dans 4 fichiers 




► Fig. 1 .4 : Les quatre fichiers texte de I'archive ZIP 

En etudiant le script precedent, il est tres aise de remarquer que la fonction qui permet 
de gerer du contenu en temps reel est addFromString(). 

bool ZipArchive: : addFromStri ng (chaTne $nom_dans_archi ve, chaTne $contenu) 

Grace a la fonction addFromStri ng () le contenu (texte) passe en second parametre 
($contenu) sera integre dans le fichier dont le nom est defini en premier parametre 
($nom_dans_archi ve) de la fonction. 

Extraire des fichiers d'une archive 

La fonction qui permet l'extraction de tout ou partie de I'archive est extractTo(). 
I mixte ZipArchive: :extractTo(chaTne $destination[, mixte $entrees] ) 

Le script ZA_extractTo.php extrait les fichiers textel.txt et texte2.txt dans un repertoire 
nomme textes. Si ce repertoire n'existe pas, il est cree. Si ce repertoire existe et qu'il 
contient des fichiers portant le meme nom que ceux a extraire, alors les fichiers deja 
existants seront ecrases sans demande de confirmation. 



ZA_extractTo.php 

<?php 

$oZA = new ZipArchive; 
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if ( $oZA->open (' ./fichiers/ addFromString .zip' ) ) { 

echo 'Extraction des fichiers texte2.txt et texte3.txt'; 
$oZA->extractTo ( ' . /f ichiers/textes/' , 

array ( ' texte2 . txt' , ' texte3 . txt' ) ) ; 
$oZA->close ( ) ; 

} else { 

echo ' echec' ; 

} 

?> 



Renommer des fichiers contenus dans l'archive 
Grace a V index 

II est possible d'agir sur les fichiers et repertoires meme lorsque ceux-ci sont deja integres 
dans l'archive. II peut etre ainsi necessaire de renommer un nchier par le biais de son 
index. C'est la fonction renamelndex() qui s'en charge. 

bool Zi pArchi ve: : renamelndex(enti er $index, chaTne $nouveau_nom) 

La fonction renamelndex() va renommer le nchier qui a pour index $index defini en 
premier parametre et lui donner le nom $nouveau_nom defmi en second parametre. 

ZA_renamelndex.php 

<?php 

$oZA = new ZipArchive ( ) ; 

$open = $oZA->open ( ' . /f ichiers/addFromString. zip' , 
ZIPARCHIVE: : CREATE) ; 

if ($open) { 

// Renomme une entree definie par son index 

echo "renommage d'un texte par le biais de son index : 

renamelndex ( ) . . . " ; 
$oZA->renameIndex ( 1 , "rename by index.txt"); 
echo 'ok<br/>'; 

$oZA->close ( ) ; 
} else { 

echo ' echec' ; 

} 

?> 
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Une fois le fichier renamelndex.php execute dans le navigateur, il vous reste a ouvrir 
1' archive addFromString.zip. Maintenant, le fichier nomme textel.php a ete renomme et 
1' archive contient a la place un fichier nomme rename _by_index. txt. Renommez le fichier 
qui a pour nom texte4.txt. 

Grace au nom 

Vous venez de voir a l'instant meme comment renommer un fichier defini par son index. 
Vous pouvez effectuer la meme action avec un fichier defini par son nom. Comme 
toujours, les fonctions PHP sont tres simples a memoriser, leurs noms etant suffisamment 
explicites. Done, apres avoir vu rename I ndex() , nous allons prendre en consideration 
renameName(). 

bool ZipArchive: :renameName(chaTne $nom_actuel , chaTne $nouveau_nom) 

La fonction renameName() prend en premier argument ($nom_actuel ) le nom actuel du 
fichier cible contenu dans l'archive et en second argument ($nouveau_nom) le nouveau 
nom qui lui sera affecte. 

ZA_renameName.php 

<?php 

$oZA = new ZipArchive () ; 

$open = $oZA->open ( ' . /f ichiers/addFromStr ing . z ip ' , 
ZIPARCHIVE: : CREATE) ; 

if ( $open) { 

/ / Renomme une entree def inie par son nom 

echo "renommage d'un texte par le biais de son nom : 

renameName ( ) . . . " ; 
$oZA->renameName ( ' texte4 . txt' , 'nouveau nom texte4.txt'); 
echo 'ok<br/>'; 

$oZA->close ( ) ; 
} else { 

echo ' echec' ; 

} 

?> 

renameName. php renomme le fichier texte4.txt en nouveau_nom_texte4.txt. 



30 



ZIP : creer des archives 



Ajouter/Lire un commentaire a l'archive ZIP 

chaTne ZipArchive: :getArchiveComment() : recupere (lit) le commentaire associe a 
l'archive. 

mixte ZipArchive: :setArchiveComment(chaTne $commentaire) : ajoute (ecrit) un 
commentaire associe a l'archive courante. Le commentaire est une chaine de 
caracteres $commentai re placee en parametre de la fonction. 

^jt ZA_commentaire.php 

<?php 

$oZA = new ZipArchive () ; 

$open = $oZA->open ( ' . /f ichiers/addFromString. zip' , 
ZIPARCHIVE: : CREATE) ; 

if ($open) { 

$readAC = $oZA->getArchiveComment ( ) ; 

echo "lecture du commentaire de l'archive ZIP : 

getArchiveComment () . . . <br/>"; 
echo '-> '. $readAC . '<br/>'; 

echo "ecriture d' un commentaire pour l'archive ZIP : 

setArchiveComment ( ) . . . <br/>"; 
$mix = $oZA->setArchiveComment ( ' le commentaire de fonctions.zip'); 

$readAC = $oZA->getArchiveComment ( ) ; 

echo "lecture du commentaire de l'archive ZIP : 

getArchiveComment ( ) . . . <br/>"; 
echo '-> '. $readAC .'<br/>'; 

} 

$oZA->close ( ) ; 
?> 

Localiser une entree 

Vous avez vu precedemment que vous pouviez renommer un fichier en selectionnant ledit 
fichier par son nom ou bien par son index. La presence d'un index signifie que les fichiers 
sont ranges dans un ordre. Vous pouvez localiser l'emplacement d'un fichier dans une 
archive avec la fonction locateName(). 

mixte ZipArchive: :locateName(chaTne $nom_fichier[, entier $drapeaux]) 
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La methode 1 ocateName() va localiser 1' emplacement du fichier cible defini dans la 
variable $nom_fichier. Le second parametre, optionnel, est un drapeau auquel on affecte 
une constante predefmie parmi les suivantes : 

FLJOCASE 
FL_N0DI R 

FL_N0CASE ignore la casse sur le nom. En clair, elle ne fera pas la difference entre les 
lettres majuscules et les lettres minuscules. FL_N0DIR ignore le composant dossier. 

ZAJocateName.php 

<?php 

$oZA = new ZipArchive ( ) ; 

$open = $oZA->open ( ' . /f ichiers/addFromStr ing . z ip' , 
ZIPARCHIVE: : CREATE) ; 

if ( $open) { 

echo "localisation d'une entree en utilisant son nom : 

locateName ( ) . . . <br />" ; 
$mix = $oZA->locateName ( ' texte3 . txt' ) ; 
echo $mix; // Affiche 2 

} 

$oZA->close ( ) ; 
?> 

Vous avez pu etudier les principales fonctions de l'extension ZIP de PHP. II en existe 
d'autres et elles sont assez nombreuses. Reportez-vous au manuel PHP (http://php.net/) pour 
en prendre connaissance. II est temps de passer maintenant a ZLIB. 

1 .3 ZLIB : Quel est son secret ? 

Jetons un ceil rapide a cette bibliotheque. ZLIB a ete creee par Jean-Loup Gailly pour la 
compression et Mark Adler en ce qui concerne la decompression. ZLIB fonctionne sous 
toutes les plates-formes (Windows, Linux et autres). 

Fonctions ZLIB 
Ouverture/Fermeture 

Les syntaxes sont evidentes et ont ete vues maintes fois dans les autres extensions qui 
gerent les fichiers : 
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resource gzopen(chaTne $nom_fichier, chaTne $mode[, entier $use_i ncl ude 
_path]) : ouvre un fichier compresse avec l'extension .gzip pour y ecrire ou y lire 
des donnees. 

bool gzcl ose (resource $gzo) : gzclose() referme le fichier $gzo ouvert avec la 
methode gzopenQ. 

^jt GZ_creer.php 

<?php 

// Peut etre utilisee pour lire un fichier qui n'est pas 

// dans un format gzip ; dans ce cas, gzreadO lira directement 

// le fichier sans decompression. 

$find in include path = 0; 

$gzo = gzopen ( ' . /test . gz ' , "w", $find in include path) 

or die ( ' Ouverture du fichier echouee' ) ; 
if (is_resource ($gzopen) ) { 

echo ' $gzopen est une ressource<br/>' ; 
} else { 

echo "\$gzopen = ". $gzopen .'<br/>'; 

} 

gzclose ($gzopen) ; 
?> 

s 

Ecriture 

Les noms de fonctions ZLIB sont souvent identiques aux noms de fonctions de BZIP2. 
La seule difference se trouve dans la premiere lettre (b pour BZIP2 et g pour ZLIB). De 
plus, elles remplissent souvent (toujours ?) la meme action. Avec BZIP2, vous avez etudie 
bzwrite() pour ecrire dans un fichier. Pour ZLIB, le nom sera gzwrite(). Comme 
explique a la phrase precedente, seule la premiere lettre change. 

entier gzwrite(resource $gzo, chaTne $chaine [, entier $taille]) 

La fonction gzwrite() va ecrire dans la ressource (fichier .gz) definie dans le premier 
parametre. Le troisieme parametre ($tai 1 1 e) est optionnel et va permettre d'imposer une 
limite de taille pour la chaine a y inscrire. 

Pour pouvoir ecrire dans la ressource $gzo, il est necessaire que celle-ci soit ouverte en 
mode Ecriture : 
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GZ_ecriture.php 

<?php 

$chaine = "Bon jour tout le monde"; 

// Ouverture du fichier en mode ecriture 
$gzo = gzopen ( ' . /test . gz ' , "w") 

or die (' Ouverture du fichier echouee'); 

// ecrit le contenu de la chaine string 
// dans le fichier compresse zp . 
gzwrite ($gzo, $chaine) ; 
unset ($chaine) ; 

gzclose ( $gzo ) ; 
?> 

Lecture 

Voici encore une fois un exemple tres simple pour savoir comment lire dans un fichier 
compresse par ZLIB. La fonction qui s'y prete est gzread(). 

chaTne gzread (resource $gzo, entier $taille) 

La fonction gzread () va lire les donnees situees dans la ressource $gzo en indiquant la 
taille maximale a lire grace au deuxieme parametre $tai lie : 



fl^jt GZ_lecture.php 


<?php 




/ / Ouverture du fichier en mode de 


lecture 


$gzopen = gzopen ('. /test . gz ' , "r") 




or die (' Ouverture du fichier . gz 


echouee' ) ; 


// lit jusqu'a length octets dans 


le fichier compresse gzip, 


// represents par zp. La lecture s 


' arrete lorsque 


//length octets (decompresses) ont 


ete lus, ou que la 


// fin du fichier a ete atteinte. 




$gzread = gzread ( $gzopen , 1024); 




echo $gzread; 




gzclose ($gzopen) ; 




?> 
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Compresser/Decompresser 

Tout aussi simple que l'ecriture et la lecture, la compression et la decompression se font 
chacune en une seule ligne de code. Les fonctions concernees sont gzcompress () pour la 
compression et gzuncompress() pour la decompression. 

chaTne gzcompress(chaTne $donnees[, entier $ni veau_compression] ) 
chaTne gzuncompress (chaTne $donnees[, entier $taille]) 

La fonction gzcompress() compresse la chaine $donnees selon un taux de compression 
$taux_compression pouvant aller de l a 9. I est le plus rapide et 9 genere la meilleure 
compression. Pour sa part, gzuncompress () decompresse la chaine $donnees compressee 
via gzcompress () jusqu'a avoir atteint la taille de $taille en octets. 

$^jt GZ_compression.php 

<?php 

$gzopen = gzopen (' . /test.gz' , "w") 

or die ( ' Ouverture du fichier .gz echouee' ) ; 

// string gzcompress ( string data [, int level] ) 

// compresse la chaine donnee en utilisant le format de donnees ZLIB. 
$chaine = "Bon jour tout le monde . " ; 

echo ' avant la compression ... <br/>$chaine = '. $chaine . ' <br/xbr/>' ; 
$gzcompress = gzcompress ($chaine) ; 

echo 'apres la compression ... <br/>$chaine= '. $gzcompress . ' <br/xbr/>' ; 

// string gzuncompress ( string data [, int length] ) 
// decompresse une chaine compressee. 
$gzuncompress = gzuncompress ($gzcompress) ; 

echo 'apres la decompression ... <br/>$chaine= '. $gzuncompress 
. ' <br/xbr/>' ; 

gzclose ($gzopen) ; 
?> 

Jouer avec le curseur de position dans le fichier 

Vous pouvez vous promener dans la chaine de donnees grace a la fonction gzseekQ ou 
revenir au debut du fichier compresse avec ZLIB au moyen de la fonction gzrewindQ. 

bool gzrewi nd (resource $gzo) 

entier gzseek(resource $gzo, entier $empl acement) 



35 



Compresser, c'est gagner.. 



La fonction gzrewind() replace le curseur de position au debut du nchier defini par le 
parametre $gzo. En fait, cela est equivalent a: gzseek($gzopen, 0);. Au contraire, 
gzseek() deplace le pointeur a un endroit precis ($empl acement) du nchier ZLIB defini 
par la ressource $gzo. 

/j\ Positionnement n-1 

Lors du choix de la position, il est indispensable de se rappeler que la position 1 dans le fichier possede 
la valeur pour la fonction gzseek() . Pour rappel, c'est exactement la meme chose pour fseek() en ce 
qui concerne le traitement des fichiers texte. 

int gztel 1 ( re source $zp) retourne la position du pointeur de position dans le 
nchier .gz. 

Tout comme pour gzseek(), gztel 1 () retournera la valeur (zero) lorsque le pointeur se 
trouvera a la premiere position dans le fichier .gz. 

GZ_curseur.php 

<?php 

$file = 'test.gz'; 

$gzopen = gzopen ( $f ile , "r", 0); 

// On lit le contenu du fichier gz en entier 
$gzread = gzread ( $gzopen, filesize ($f ile) ) ; 
echo $gzread .'<br/>'; 

// On lit la position du pointeur de lecture 
$gztell = gztell ( $gzopen ) ; 
echo $gztell .'<br/>'; 

// On revient au debut du fichier 

gzrewind ( $gzopen ) ; 

$gztell = gztell ( $gzopen ) ; 

echo $gztell .'<br/>'; 

// On deplace le curseur a la 5e position 

// ATTENTION: la lere position a pour valeur 

// done la 5e position a pour valeur 4 

$gzseek = gzseek ( $gzopen, 4); 

$gztell = gztell ( $gzopen ) ; 

echo $gztell .'<br/>'; 
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// On lit de la position actuelle jusqu'a la fin du fichier 
$gzread = gzread ( $gzopen, filesize ($file) ) ; 
echo $gzread . '<br/>'; 

gzclose ($gzopen) ; 
?> 

Lecture partielle dans le fichier 

Lors de l'etude de la fonction gzread (), le contenu entier du fichier .gz a ete lu. gzread (), 
grace a son second argument, permet aussi de lire un nombre tres precis de signes dans 
le fichier. Et une fonction tres interessante, nommee gzpassthru (), permet de connaitre 
le contenu restant a lire. 

int gzpassthru(resource $zp) 



GZ_finir_lecture.php 


<?php 






$gzopen = gzopen ( ' . /test . gz' , "r") 
or die ( ' Ouverture du fichier .gz 


echouee' ) ; 




$gzread = gzread ( $gzopen , 2); 

echo ' lecture de 2 caracteres de la 

// affiche: Bo 


chaine = ' 


. $gzread .'<br/>'; 


$nchar = gzpassthru ($gzopen) ; 






echo '<br/>'. $nchar; 






gzclose ($gzopen) ; 
?> 







Recuperer un fichier formate 

ZLIB permet de compresser des donnees. II ne cherche aucunement a savoir ce que vous 
avez formate. Done, le fichier peut contenir du texte pur, du texte au format HTML ou 
XML ou autre encore. Voici un exemple avec une page Internet ecrite en HTML. 

Les fonctions qui vont etre utilisees dans cet exemple sont les suivantes : 

string gzgetc (resource $zp) retourne une chaine contenant un seul caractere. Cela 
revient a faire gzread($gzopen, l) L'avantage de gzgetcQ est que cette fonction 
est plus rapide pour lire un seul caractere. 
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string gzgets(resource $zp, int $length) retourne une chame d'une taille 
maximale n-1, ou la valeur n est affectee a la variable $length. 
string gzgetss (resource $zp, int $length [, string $bal i ses_permises] ) est 
identique a gzgets() avec en plus la suppression de toutes les balises HTML et PHP 
du contenu lu dans le fichier .gz. Les variables $bal i ses_permi ses represented les 
balises HTML que gzgetss () doit laisser dans le texte lu. 

GZ_page_HTML.php 

<?php 

// La chalne sur laquelle effectuer les manipulations 
$chaine = "<htmlxheadxtitle>Utilisation ZLIB</titlex/head>" ; 
$chaine .= "<body>On etudie en ce moment <i>l ' extension " ; 
echo "<b>ZLIB</bx/ix/bodyx/html>" ■ 

II Ouverture du fichier test.gz en mode ecriture 
$gzopen = gzopen ( ' . /test . gz' , "w") 

or die (' Ouverture du fichier . gz echouee' ) ; 

// On ecrit la chaine dans le fichier test.gz 
gzwrite ($gzopen, $chaine) ; 

// on detruit la variable $chaine 
unset ($chaine) ; 

gzclose ($gzopen) ; 

$file = 'test.gz'; 

/ / ouverture du fichier en mode lecture 
$gzopen = gzopen ( $file , "r", 0); 

// Lecture du contenu du fichier gz en entier 

$gzread = gzread ( $gzopen, filesize ($f ile) ) ; 

echo 'lecture du contenu du fichier avec gzread () 

et htmlentities ().. .<br/>' ; 
echo htmlentities ( $gzread) . ' <br/xbr/>' ; 

// Retour du pointeur de lecture au debut du fichier 
gzrewind ( $gzopen ) ; 

// Deplacement du curseur a la 4e position 

echo 'Deplacement du curseur a la 5e position, <br/>' ; 

$gzseek = gzseek ( $gzopen, 3) ; 
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echo ' et on affiche le caractere qui y est positionne avec 

gzgetc ( ) . . . <br/>' ; 
$gzgetc = gzgetc ( $gzopen ) ; 
echo $gzgetc . ' <br/xbr />' ; 

// Retour du pointeur de lecture au debut du fichier 
gzrewind ( $gzopen ) ; 

echo 'Affichage du contenu du fichier avec gzgets ()... <br/>' ; 
$gzgets = gzgets ( $gzopen, f ilesize ($f ile) ) ; 
echo $gzgets . ' <br/xbr/>' ; 

// Retour du pointeur de lecture au debut du fichier 
gzrewind ( $gzopen ) ; 

echo 'Affichage du contenu avec gzgetss ()... <br/>' ; 
echo ' Seule la balise HTML des caracteres gras 

(<b>) <br/>' ; 

$gzgetss = gzgetss ($gzopen, f ilesize ($f ile) , "<b>"); 
echo $gzgetss; 

gzclose ($gzopen) ; 
?> 

Compression/Decompression : DEFLATE 

DEFLATE est un algorithme de compression/decompression sur les donnees. II obeit a la 
norme RFC1951. Autrement dit, DEFLATE va compresser des donnees et ces donnees 
compressees seront sauvegardees dans un fichier compresse a l'aide de ZLIB. 

string gzdef l ate(stri ng $data [, int $level]) compresse les donnees. 
string gzinfl ate(string $data [, int $taille]) decompresse les donnees. Le 
second argument, $tai 1 1 e, de la fonction i nf l ate() indique le nombre de caracteres 
a decoder. 

GZ_deflate_inflate.php 

<?php 

$gzopen = gzopen ( ' . /test . gz' , "w") 

or die ( ' Ouverture du fichier .gz echouee' ) ; 

$chaine = "Bon jour tout le monde . " ; 

echo ' avant encodage . . . <br/>$chaine = '. $chaine . ' <br/xbr/>' ; 
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// string gzdeflate ( string data [, int level] ) 




// compresse la chaine donnee en utilisant 




// le format de donnees DEFLATE. 




$gzdeflate = gzdeflate ( $chaine ) ; 




echo 'apres encodage . . . <br/>$chaine = '. $gzdeflate 


' <br/xbr/>' ; 


// string gzinflate ( string data [, int length] ) 




// decompresse une chaine compressee avec la methode 


gzdeflate ( ) . 


$gzinflate = gz inflate ( $gzdef late ) ; 




echo 'apres decodage . . . <br/>$chaine = '. $gzinflate . 


' <br/xbr/>' ; 


gzclose ($gzopen) ; 




?> 





1 .4 Cas pratique : gestion des donnees et fichiers 

Les programmeurs experimentes sauvegardent souvent les erreurs generees par 
1' application dans des fichiers texte appeles fichiers de logs. Or, vous avez vu que 
sauvegarder des donnees textuelles dans un fichier compresse permet d' avoir un gain de 
place. Ann de comparer les trois methodes, a savoir textes, fichiers compresses BZIP2 et 
archives ZIP, nous vous presentons en guise de cas pratique un exemple avec un 
formulaire de connexion. Si vous saisissez le bon pseudonyme (login) et le bon mot de 
passe (password), 1' application vous inscrit un message de confirmation a l'ecran 
particulierement delicat. Par contre, si le pseudonyme ou le mot de passe ne valident pas 
votre identite, alors un message d'erreur sera sauvegarde afin que le webmaster puisse en 
prendre connaissance ulterieurement. 

Afin de bien comparer les trois methodes vues precedemment, nous allons effectuer les 
trois types de sauvegarde. L'objectif ici n'est pas de trouver le login et le mot de passe 
mais bien de se tromper une centaine de fois afin de comparer la difference de taille des 
fichiers/archives generes sur le disque dur et savoir quelle methode est la plus econome 
en termes d'espace disque. C'est la raison pour laquelle nous vous avons cache le login 
et le mot de passe dans un autre chapitre du livre afin de vous laisser chercher des 
informations la ou vous n'iriez pas habituellement. 



cas_pratiquel .php 

<html> 
<head> 

<title>Gagnez de l'espace disque</ title> 
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</head> 

<body> 

<?php 

if (isset ($_POST [' login' ] ) SS isset ( $_POST [' password' ])) { 
// Les versions non cryptees de $bonlogin et $bonpassword 
// se trouvent quelque part dans le livre 
// les deux sont mis ensemble et dans 
// un petit cadre. Regardez bien 

$bonlogin = ' 34 91e6c6121cl 10 30 677 67 3a74 352 9c08 80c4 580 ' ; 
$bonpassword = ' debal2df 7f 2e 9c6b4bbl31f 00ba4e8 6624d56baf ' ; 

if (shal ($_POST [' login' ] ) == $bonlogin && 

shal ($_POST ['password' ] ) == $bonpassword) { 

echo ' Tu es trop fort!!!'; 
} else { 

$time = time ( ) ; 

echo $time; 

// On ecrit dans bzip2 
$str = 'plante le '. $time; 

$bzo = bzopen('./bzip2/'. $time . ' . bz2 ' , "w" ) ; 
$bzw = bzwr ite ( $bzo, $str, strlen ( $str )) ; 
bzclose ( $bzo ) ; 

// On ecrit dans textes 
$pathname = './textes/'; 
$filename = $time .'.txt'; 

$fp = f open ( $pathname . $filename, "w+") ; 
fwrite($fp, $str, strlen ($str) ) ; 

// On ecrit dans une archive ZIP 
$zip = new ZipArchive () ; 

if ( $zip->open ( ' . /erreurs login.zip', ZipArchive :: CREATE) ) { 
$ zip->addFile ( $pathname . $filename, $f ilename) ; 
echo 'ok' ; 

} else { 

echo ' echec' ; 

} 

$zip->close ( ) ; 
f close ( $f p ) ; 

} 

} else { 

echo 'vous devez saisir un login et un mot de passe'; 

} 
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?> 

<form action="#" method="POST"> 

login <input type="text" name="login" /><br/> 

password <input type="password" name="password" /><br/> 

<input type=" submit" name="valider " value="Valider " /> 

</ f orm> 

</body> 
</html> 

Trompez-vous une bonne centaine de fois et comparez les differences de taille entre le 
repertoire bz.ip2, le repertoire texte et 1' archive zippee. Attention, la difference est tres 
nette. 

Quant a la surprise, elle est de taille. Et le vainqueur est... le repertoire textes ! Le 
deuxieme est le repertoire bzip2 et le dernier 1' archive ZIP. Pourquoi me 
demanderez-vous ? Simplement parce que la compression, que ce soit en ZIP ou en 
BZIP2, demande des operations algorifhmiques a effectuer et done une plus grande taille 
dans le fichier. Ce qui signifie que pour un grand nombre de fichiers contenant tres peu 
de donnees, les fichiers texte sont les plus legers puisqu'ils ne subissent aucune 
transformation. Voyons maintenant un cas pratique, le meme a vrai dire, sauf que cette 
fois nous allons sauvegarder les messages d'erreurs dans un meme fichier qui aura une 
validite d'une journee. 

Au niveau metier, cette logique est d'ailleurs beaucoup plus facile a gerer pour le 
webmaster qui peut recuperer les erreurs au jour le jour. Voici done le code qui, pour les 
trois methodes, ajoute les messages d'erreurs en fin de fichier et ce, pendant une journee 
complete de 24 heures. 

cas_pratique2.php 

<html> 
<head> 

<title>Gagnez de la place</ title> 

</head> 
<body> 
<?php 

if (isset ($_POST [' valider' ] ) && isset ( $_POST [ ' 
^ isset ($_POST [ 'password' ])) { 

// L' important ici n'est pas de trouver le 

// Mais justement de se tromper deux cents 



login' ] ) && 
bon login 

ou trois cents fois 



4S 



Cas pratique : gestion des donnees et fichiers 



1 



// dans une journee et comparer la taille 

$bonlogin = ' 34 91e6c6121cl 10 30 677 67 3a74 352 9c08 80c4 580 ' ; 

$bonpassword = ' debal2df 7f 2e9c6b4bbl31f 00ba4e8 6624d56baf ' ; 

if (shal ($_POST [' login' ] ) == $bonlogin SS shal ( $_POST [' password' ] ) == 
$bonpassword) { 
echo ' Tu es trop fort 
} else { 

$str = "L' utilisateur a echoue lors de sa tentative de connexion le 

". date ("d/m/Y", time()) .'a', date ( "H : i : s " , time()) ."\n"; 
$time = date ("Y-m-d", time()); 
echo $time .'<br/>'; 

////// 

// On enregistre avec BZIP2 

$nom fichier = './bzip2/'. $time . '.bz2'; 

// Si le fichier du jour n'existe pas, il est cree, 

// sinon les donnees sont ecrites a la suite des donnees existantes 
$bzo = bzopen ($nora fichier, "w"); 
// On ecrit dans bzip2 

$bzw = bzwrite ( $bzo, $str, strlen ( $str )) ; 
bzclose ($bzo) ; 
// Fin de BZIP2 
////// 

////// 

// On ecrit dans le fichier texte quotidien 
//$pathname = './textes/'; 

$nom fichier = './textes/'. $time .'.txt'; 
$fp = fopen ($nom fichier, "a+"); 
fwrite($fp, $str, strlen ($str) ) ; 
/ / Fin fichiers texte 

////// 

////// 

// On ecrit dans une archive ZIP 
$zip = new ZipArchive () ; 

if ( $zip->open ( ' . /erreurs login.zip', ZipArchive :: CREATE) ) { 

$ zip->addFile ( $nom_f ichier , $nom fichier); 

echo ' ouverture archive ZIP --> ok'; 
} else { 

echo 'ouverture archive ZIP --> echec' ; 

} 

$ zip->close ( ) ; 
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// Fin ZIP 
////// 

f close ( $ f p ) ; 

echo ' <br/xbr/>echec de connexion. 

Allez, un peu de courage, vous y etes presque.'; 

} 

} else { 

echo 'vous devez saisir un login et un mot de passe'; 

} 

?> 

<form action="#" method="POST"> 

login <input type="text" name="login" /><br/> 

password <input type="password" name="password" /><br/> 

<input type=" submit" name="valider " value="Valider " /> 

</form> 

</body> 
</html> 

Dans ce deuxieme cas pratique, nous decouvrons une limite de BZIP2. II ne permet pas 
d'ajouter des donnees. II ecrase automatiquement le fichier BZIP existant pour en creer 
un nouveau alors que ZIP, recuperant toujours le fichier texte qui se met a jour a chaque 
tentative de connexion echouee, ecrase simplement le fichier texte existant dans son 
archive. II est done tres facile de faire evoluer le script de telle sorte que, au fur et a 
mesure du temps, c'est toujours la meme archive ZIP, mais avec l'ajout de chaque fichier 
texte genere quotidiennement. 

Ces deux cas pratiques peuvent done etre considered comme des tests pour en venir au 
cas pratique definitif qui est cas _pratique3.php. 



Ifcfj, cas_pratique3.php 



<html> 




<head> 




<title>Gagnez de la place</ title> 




</head> 




<body> 




<?php 




if(isset($ POST['valider' ] ) && isset($ POST [' login' ] 


&& 


isset($ POST ['password' ] ) ) { 
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// L' important ici n'est pas de trouver le bon login 

// Mais justement de se tromper deux cents ou trois cents fois 

// dans une journee et comparer la taille 

$bonlogin = ' 34 91e6c6121cl 10 30 677 67 3a74 352 9c08 80c4 580 ' ; 

$bonpassword = ' debal2df 7f 2e9c6b4bbl31f 00ba4e8 6624d56baf ' ; 

if (shal ($_POST [' login' ] ) == $bonlogin && shal ( $_POST [' password' ] ) == 
$bonpassword) { 
echo ' Tu es trop fort!!!'; 
} else { 

$str = "L' utilisateur a echoue lors de sa tentative de connexion le 
". date ("d/m/Y", time()) .'a', date ( "H : i : s " , time()) ."\n"; 

////// 

/ / Ecriture dans le f ichier texte quotidien 

// Definir la date du jour 

$aujourd_hui = date ( " Y-m-d" , time()); 

echo "aujourd'hui = ". $aujourd hui . '<br/>'; 

/ / Definir le f ichier quotidien 

$nom fichier = './textes/'. $aujourd hui .'.txt'; 

// S'il s'agit d' une nouvelle journee, 
// creer un nouveau fichier du jour 
if (! file exists ($nom fichier) ) { 

// On def init la date de la veille 
$hier = date ( "Y-m-d" , time() - 86400); 
echo 'hier = '. $hier . ' <br/xbr/>' ; 

// Recuperer le fichier de la veille 

$nom fichier hier = './textes/'. $hier .'.txt'; 

// Renommer le fichier de la veille au fichier du jour 

rename ($nom fichier hier, $nom fichier); 

// Ecraser les donnees existantes de la veille 
$fp = fopen($nom fichier, "w+"); 

// Si c'est le fichier deja cree pour la journee, 
// On a j oute les donnees a la suite du fichier 

} else { 

$fp = fopen($nom fichier, "a+"); 
fwrite($fp, $str, strlen ( $ str ) ) ; 

} 

/ / Fin fichiers texte 
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// On ecrit dans une archive ZIP 
$zip = new ZipArchive () ; 

if ( $z ip->open ( ' . /erreur s login.zip', ZipArchive :: CREATE) ) { 

$ zip->addFile ( $nom_f ichier , $nom fichier); 

echo ' ouverture archive ZIP --> ok'; 
} else { 

echo 'ouverture archive ZIP --> echec' ; 

} 

$zip->close ( ) ; 
// Fin ZIP 
////// 

f close ( $ f p ) ; 

echo ' <br /><br/>echec de connexion. Allez, 

un peu de courage, vous y etes presque.'; 

} 

} else { 

echo 'vous devez saisir un login et un mot de passe'; 

} 

?> 

<form action="#" method="POST"> 

login <input type="text" name="login" /><br/> 

password <input type="password" name="password" /><br/> 

<input type=" submit" name="valider " value="Valider " /> 

</f orm> 

</body> 
</html> 

Avec ce troisieme cas pratique, les seuls fichiers existants seront le fichier texte du jour 
ainsi qu'une seule archive ZIP qui contiendra toutes les donnees. 

1 .5 Check-list 

Dans ce chapitre, nous avons vu : 

✓ les extensions BZIP2, ZIP et ZLIB ; 

comment creer des fichiers de donnees compressees avec BZIP2 ; 
comment creer des archives avec ZIP ; 
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1/ la totalite des fonctions de ZLIB ; 

*/ comment compresser avec chacune des extensions de ZLIB ; 
«/ comment decompresser avec chacune des extensions de ZLIB ; 
la gestion de fichiers et dossiers compresses. 
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2. 1 COM : creer des documents Microsoft Office 

2.2 DOM : de XML d OpenOffice.org (OOo) .... 

2.3 Check-list 



Utili 



iser 



la bureautique 



Avez-vous dejd eu besoin d'exporter le contenu d'une 
base de donnees en un fichier Microsoft Excel ? Ou 
OpenOffice.org Calc ? Nous pouvons le faire facilement 
grace d quelques extensions de PHP. 



Utiliser la bureautique 



2.1 COM : creer des documents Microsoft Office 

COM, c'est l'extension qui va nous permettre de creer des documents Microsoft Office. 
COM signifie Component Object Model et permet a du code ecrit en n'importe quel 
langage d'interagir avec du code ecrit dans un autre langage, a condition que ces deux 
langages respectent les conventions de nommage COM. Ce qui tombe plutot bien, vu que 
PHP et Visual Basic les respectent. . . Nous allons done utiliser COM arm que PHP puisse 
manoeuvrer Visual Basic. 

Meme s'il est preferable de connaitre Visual Basic, vous pourrez vous en sortir sans rien 
savoir de ce langage. 

Decouvrir COM 

Tout d'abord, sachez que COM fait partie du coeur de PHP. II n'y a done rien a faire pour 
pouvoir l'utiliser, si ce n'est s'assurer que le langage avec lequel nous souhaitons faire 
communiquer PHP soit bien installe. Dans notre cas, cela se resume a s'assurer que 
Microsoft Word (si vous voulez generer un document Word) ou Excel (pour un document 
Excel) soit installe sur votre systeme. 

Un fichier Microsoft Word 

Nous allons commencer simplement, en ecrivant une petite phrase dans un document 
Word. Dans un repertoire nomme chap02, creez le fichier com_word.php et remplissez-le 
comme ceci : 

fl^j com_word.php 

<?php 

$repertoire = "D:\dynamisez PHP\chap02" ; 
?> 

Lorsque nous aurons besoin d'enregistrer notre fichier, nous utiliserons un chemin absolu 
pour indiquer le repertoire hote. 

Les quelques lignes que nous allons rajouter maintenant servent a instancier 
Microsoft Word : 

/ / Demarrage de Word 
$word = new COM ( "word . application" ) 
or die ( "Impossible de lancer Word"); 
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En fait, l'objet COM que nous venons de creer et de mettre de cote dans la variable $word 
est une instance de 1' application Microsoft Word. C'est done a travers la variable $word 
que nous donnerons des instructions en Visual Basic. Et la premiere chose que nous allons 
faire, c'est de creer un document sur lequel s'appliqueront nos modifications : 

/ / Cree un document vide 
$word->Documents->Add ( ) ; 

Pour le moment, ne vous preoccupez pas de la syntaxe : nous sommes en train de faire 
du Visual Basic, nous y reviendrons ulterieurement. Voici maintenant la ligne qui va nous 
permettre d'inscrire une phrase dans notre document : 

// ecrit dans le document 

$word->Selection->TypeText ("Hello world !"); 

Nous decidons ensuite que le mot "worl d" soit en gras. II va done nous falloir selectionner 
ce mot : 

// deplacer le curseur de deux caracteres 
$word->Selection->MoveLef t (1, 2) ; 
// Selectionner 5 caracteres 
$word->Selection->MoveLef t (1, 5, 1 ) ; 

Puis le faire passer en gras : 

// Passer la selection en gras 
$word->Selection->Font->Bold=99 99 998; 

II ne nous reste plus qu'a enregistrer notre fichier, en specifiant d'abord le bon chemin 
d'enregistrement : 

// Selectionner un repertoire 
$word->ChangeFileOpenDi rectory ( $repertoire ) ; 
// Enregistrer le fichier 

$word->ActiveDocument->SaveAs ("test. doc") ; 

Et n'oublions pas de fermer notre instance de Microsoft Word et de liberer la memoire : 

//Fermeture de Word 
$word->Quit ( ) ; 

// Liberation des ressources 
$word = null; 

Vous pouvez maintenant lancer le fichier comjword.php depuis votre navigateur favori. 
Rien ne s'affichera a l'ecran mais votre fichier a bien ete sauvegarde a l'endroit convenu. 
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Voici le code complet du fichier com_word.php : 
com_word.php 

<?php 

$repertoire = "D:\dynamisez PHP\chap02" ; 

/ / Demarrage de Word 
$word = new COM ( "word . application" ) 
or die ( "Impossible de lancer Word"); 

/ / Cree un document vide 
$word->Documents->Add ( ) ; 

// ecrit dans le document 

$word->Selection->TypeText ( "Hello world !"); 

// deplacer le curseur de deux caracteres 
$word->Selection->MoveLef t ( 1 , 2 ) ; 
// Selectionner 5 caracteres 
$word->Selection->MoveLef t ( 1 , 5, 1 ) ; 

// Passer la selection en gras 
$word->Selection->Font->Bold=99 99 998; 

/ / Selectionner un repertoire 

$ wo rd->ChangeFileOpenDi rectory ( $ repertoire ) ; 

// Enregistrer le fichier 

$word->ActiveDocument->SaveAs ("test. doc") ; 
//Fermeture de Word 
$word->Quit ( ) ; 

// Liberation des ressources 

$word = null; 

?> 

La documentation de COM 

Maintenant que le premier fichier Microsoft Word a ete cree, attardons-nous un peu sur 
la partie Visual Basic de notre code. En effet, toutes les fonctions que nous avons utilisees 
dans le fichier comjword.php (TypeTextQ, MoveLeft()...) sont des fonctions 
Visual Basic, et non des methodes de l'objet COM. C'est pour cela que la documentation 
de COM ne nous interesse pas. Nous allons maintenant voir comment obtenir du code 
Visual Basic executant les actions que nous souhaitons, et comment le retranscrire au sein 
de notre code PHP. 
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Obtenir du code Visual Basic 

Commencons par ouvrir Microsoft Word, exactement comme si nous allions rediger un 
nouveau document. 

Dans le menu Outils, selectionnez le sous-menu Macro, puis cliquez sur Nouvelle 
Macro... ; une boite de dialogue s'ouvre alors. 



Enregistrer une macro 



Nom de la macro : 



InouveauFichier 
Affecter la macro au(x)- 



Barres d'outils Cjavier 
Enregistrer la macro dans : 



Tous les documents (normal. dot) 
Description : 



Macro enregistree le 16/11/2007 



Fig. 2.1 : 

Creer une nouvelle 



Donnez-lui un nom explicite, puis cliquez sur 
OK. Une nouvelle petite fenetre apparait a 
l'ecran. 

Cette petite fenetre ne presente que deux 
boutons dont les symboles sont eloquents : nous sommes visiblement en train 
d'enregistrer quelque chose, mais quoi ? Tout bonnement l'ensemble des modifications 
que nous allons maintenant faire a notre document. 

Nous allons done creer un nouveau document vide en cliquant sur Nouveau, dans le 
menu Fichier. Dans ce nouveau document, ecrivons "Hello world !" puis selectionnons 
le mot "world" a l'aide du clavier (tant que nous sommes en train d'enregistrer notre 
macro, les selections de texte ne peuvent se faire a la souris). Mettons-le en gras, puis 
enregistrons notre document sur notre disque dur. Nous pouvons enfin arreter 
l'enregistrement de la macro en cliquant sur le bouton carre du petit enregistreur. 

Notre macro, e'est-a-dire la suite des instructions Visual Basic permettant de creer un 
nouveau document, d'ecrire "Hello world !" a l'interieur et bien d'autres choses, est 
done enregistree et visible quelque part. Pour la voir, selectionnez le sous-menu Macro 
(dans le menu Outils) et cliquez sur Macros... 



i iy. . 

Un enregistreur ? 
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Nom de la macro : 
|nouveauFichier| 



Macros disponibles dans : 



| Normal, dot (modele global) 
Description : 



Macro enregistree le 19/1 1/2007 



Executer pas a pas 



Supprimer 



Organiser.. 



► Fig. 2.3 : 

Selectionnez votre 



Dans la boite de dialogue qui apparait, selectionnez votre macro, puis cliquez sur le 
bouton Modifier. L'editeur Visual Basic s'ouvre alors, affichant votre macro. Voici a quoi 
elle ressemble : 



macro nouveauFichier 

Sub nouveauFichier ( ) 

' nouveauFichier Macro 

' Macro enregistree le 16/11/2007 
i 

Documents . Add Template := 

"C:\Documents and SettingsY.ANormal . dot" 

, NewTemplate : =False, DocumentType : =0 
Selection. TypeText Text:="Hello world !" 
Selection . MoveLeft Unit : =wdCharacter , Count: =2 

Selection . MoveLeft Unit : =wdCharacter , Count:=5, Extend: =wdExtend 
Selection . Font . Bold = wdToggle 

ChangeFileOpenDirectory "D:\dynamisez PHP\chap02" 
ActiveDocument . SaveAs FileName : ="Helloworld . doc" , FileFormat:= 
wdFormatDocument, LockComments : =False , Password :="" , 

AddToRecentFiles := 
True, WritePassword : =" " , ReadOnlyRecommended: =False, 

EmbedTrueTypeFonts : = 
False, SaveNativePictureFormat : =False, SaveFormsData : =False, 
SaveAsAOCELetter : =False 

End Sub 
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Comprendre le code Visual Basic et l'interpreter en PHP a travers COM 

Nous pouvons voir, dans la premiere ligne de ce code que Ton demande a un objet de 
1' application, Documents, d'ajouter (via, visiblement, une methode Add()) quelque chose. 
La methode Add() contient plusieurs arguments: Template, NewTemplate et 
DocumentType. Voici comment nous ecrivons cette ligne, dans notre fichier comjword 
.php : 

$word->Documents->Add ( ) ; 

Notre variable $word contient une instance de Microsoft Word. Nous cherchons a 
atteindre l'objet Document de 1' application, c'est pourquoi il y a une fleche (->) entre notre 
variable et l'objet Document. Ce meme objet Document dispose d'une methode Add () , ainsi 
que nous le specifie le code Visual Basic contenu par notre macro, qui nous permet 
d'ajouter un document sur lequel travailler. Comme vous pouvez le voir, nous ne passons, 
en PHP, aucun parametre a la methode Add(). Les noms de ces arguments, apparaissant 
dans le code Visual Basic, nous renseignent sur leur nature : ils ne servent qu'a decrire un 
document Word par defaut. 

Neanmoins, avant d'enlever ses parametres, nous nous sommes assures, en faisant des 
tests avec et sans, que cela marchait. Lorsque vous decouvrirez de nouvelles fonctions, ou 
de nouveaux objets Visual Basic, il vous faudra bien les tester au sein de votre code PHP ! 

(J) Les fonctions en Visual Basic 

Lorsque I'on appelle, en Visual Basic, une methode ou une fonction, nous ne passons pas les 
parametres a cette derniere en utilisant des parentheses. On separe (par un espace) le nom de la 
fonction et ses arguments, et on donne le nom de chaque parametre. Ce sont ces specificites 
syntaxiques qui nous permettent de savoir que I'on a affaire d une fonction et de la traiter comme telle 
depuis PHP. 

Regardons la deuxieme ligne du code Visual Basic : 

Selection . TypeText Text:="Hello world !" 

Elle nous informe de l'existence d'un objet Selection dans 1' application Word ; et que 
cet objet dispose d'une methode TypeText () qui ne prend qu'un seul argument nomme 
Text. De par le nom de la methode, nous comprenons qu'il s'agit de l'instruction ecrivant 
"Hel 1 o worl d ! " dans notre document. Le parametre a passer est done la chaine a ecrire. 
Voici comment nous l'interpretons en PHP : 

$word->Selection->TypeText ("Hello world ! " ) ; 
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Vous comprenez l'astuce ? Les differences de syntaxe qu'il y a entre PHP et 
Visual Basic ? 

Les constantes : de Visual Basic vers PHP 

L'etape d'apres consiste a selectionner le mot "world". II va done falloir deplacer le 
curseur, qui se trouve a la fin de la chaine "Hello world !", de deux caracteres vers la 
gauche, de maniere a le positionner juste apres le dernier caractere du mot "world". Voici 
1' instruction Visual Basic : 

Selection . MoveLeft Unit : =wdCharacter , Count:=2 

Comme nous le voyons, e'est encore l'objet Selection qui entre en jeu, par le biais d'une 
methode MoveLeft (). Cette methode necessite deux parametres : Unit et Count. Encore 
une fois, e'est le nom de ces parametres et de ces mefhodes qui va nous permettre d'en 
comprendre la nature. 

Ainsi, la methode MoveLeft () laisse clairement entendre, de par son nom, qu'elle va 
deplacer le curseur vers la gauche (et nous en profitons pour deduire qu'il doit exister une 
methode MoveRight()). Le premier argument, Unit, demande clairement quelle va etre 
l'unite etalon, et le second argument, Count, demande de combien d'unites nous allons 
nous deplacer. 

Voici comment nous integrons cela en PHP : 

$word->Selection->MoveLef t ( 1 , 2 ) ; 

Le second parametre, Count, etant un nombre, nous le faisons apparaitre en tant que tel 
en PHP. Le premier parametre, Uni t, en revanche, n'est ni une chaine de caracteres (dans 
le code Visual Basic, le mot wdCharacter n'est pas entre guillemets), ni un nombre. II 
s'agit d'une constante propre a Microsoft Word ; e'est pourquoi nous ne pouvons utiliser 
directement ce nom de constante dans notre code PHP, mais plutot la valeur de cette 
constante. Mais alors, comment connaitre le contenu de la constante wdCharacter ? 

Pour cela, il va nous falloir faire un peu de Visual Basic. Dans l'editeur Visual Basic, 
juste en dessous de notre precedente macro, ecrivons le code Visual Basic suivant : 

Macro ecritConstante 

Sub ecritConstante ( ) 

Selection. TypeText Text : ="wdCharacter " 
Selection . TypeText Text : =wdCharacter 
Selection . TypeParagraph 
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Selection 


TypeText Text: 


="wdExtend " 


Selection 


TypeText Text. 


=wdExtend 


Selection 


Type Paragraph 




Selection 


TypeText Text: 


="wdToggle " 


Selection 


TypeText Text: 


=wdToggle 


Selection 


Type Paragraph 




End Sub 







Cette macro va simplement ecrire dans le document Word courant les noms des 
constantes que nous utilisons dans le fichier comjword.php suivis de leurs contenus. 
Fermez l'editeur Visual Basic (inutile d'effectuer une sauvegarde). Vous pouvez 
maintenant lancer votre nouvelle macro dans Microsoft Word en cliquant sur Macros... 
dans le sous-menu Macro du menu Outils. Selectionnez votre macro dans la boite de 
dialogue qui apparait, puis cliquez sur Executer. Dans votre document Word, il y a 
maintenant trois lignes, et la premiere vous renseigne sur le contenu de la constante 
wdCharacter : celle-ci vaut 1. 

Maintenant que nous avons deplace notre curseur juste derriere le mot "world", nous 
allons le selectionner. Voici ce que nous dit le code Visual Basic : 

Selection . MoveLeft Unit : =wdCharacter , Count:=5, Extend : =wdExtend 

Nous allons encore une fois utiliser la methode MoveLeft () de l'objet Selection mais, 
cette fois, un parametre de plus a fait son apparition : Extend. II est la pour signifier que 
nous allons etendre la selection courante en meme temps que nous deplacons le curseur. 
Comme il s'agit d'une constante, nous executons notre macro ecri tConstante, et nous 
apprenons qu'elle vaut 1. Voici done comment interpreter cette ligne de Visual Basic dans 
notre code PHP : 

$word->Selection->MoveLeft (1, 5, 1 ) ; 

Nous avons selectionne notre mot. Nous allons le passer en gras. En Visual Basic, cela se dit : 

Selection . Font . Bold = wdToggle 

Cette fois, la syntaxe Visual Basic nous indique que nous allons manipuler l'objet Font, 
appartenant lui-meme a l'objet Selection. Cette fois-ci, ce n'est pas un appel a une 
methode que nous allons effectuer. Nous allons simplement changer la valeur de l'attribut 
Bol d. Encore une fois nous allons utiliser une constante done, encore une fois, nous allons 
lancer notre macro ecri tConstante pour apprendre que cette constante vaut 9999998. 
L' interpretation en PHP est la suivante : 

$word->Selection->Font->Bold=99 99 998; 
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Sauvegarder le fichier et liberer les ressources 

II ne nous reste plus qu'a sauvegarder et a liberer les ressources. Voici comment opere le 
code Visual Basic pour la sauvegarde : 

ChangeFileOpenDirectory " D:\dynamisez PHP\chap02" 

ActiveDocument . SaveAs FileName : ="Helloworld . doc" , FileFormat : = 
wdFormatDocument, LockComments : =False , Password :="" , 

AddToRecentFiles := 
True, WritePassword : =" " , ReadOnlyRecommended: =False, 

EmbedTrueTypeFonts : = 
False, SaveNativePictureFormat : =False, SaveFormsData : =False , 
SaveAsAOCELetter : =False 

Tout d'abord, nous assignons un "repertoire courant" grace a la methode 
ChangeFileDi rectory (). Cette methode dispose de plusieurs arguments dont nous 
n'avons nul besoin. C'est pourquoi nous la traduirons ainsi au sein de notre fichier PHP : 

$word->ChangeFileOpenDirectory ( $repertoire ) ; 

La seconde methode, SaveAsQ, est issue de l'objet ActiveDocument. Encore une fois, 
nous n'avons pas besoin de tous ses arguments : 

$word->ActiveDocument->SaveAs ("test. doc") ; 
(j) Ne maltraitez pas les arguments ! 

Dans cette demonstration, nous n'utilisons pas systematiquement tous les arguments d'une methode ou 
fonction. Lorsque vous vous retrouverez face d des fonctions inattendues ou inconnues, prenez le temps 
de tester pour verifier que tout marche bien, avant de supprimer des arguments a priori inutiles I 

Notre fichier etant sauvegarde, nous devons encore fermer notre instance de 
Microsoft Word avant de liberer les ressources : 

//Fermeture de Word 
$word->Quit ( ) ; 

// Liberation des ressources 
$word = null; 

Notre fichier est termine, et nous avons appris a comprendre Visual Basic pour 1' utiliser 
avec PHP via COM. Cependant, n'oubliez pas qu'il ne s'agit que d'astuces pour vous 
eviter de l'apprendre. Si d'aventure, vous etes amene a generer des documents plus 
complexes, l'apprentissage de Visual Basic sera necessaire... 
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Exporter des donnees de SQL vers Microsoft Excel 

Avec les connaissances acquises depuis le debut de ce chapitre, vous devriez y arriver 
sans trop d'inconvenients Mais nous allons quand meme vous accompagner encore un 
peu dans l'utilisation de COM, ou plutot dans l'utilisation de Visual Basic en PHP via 
COM. 

Notre base de donnees 

Ce n'est pas la peine de se compliquer la vie. Une seule table avec peu de donnees suffira. 
Nous allons done creer une nouvelle base que nous appellerons "meteo" : 

CREATE DATABASE 'meteo' ; 

Au sein de cette base, creons la table "temperature" : 

CREATE TABLE ' meteo' .' temperature' ( 

' id' INT NOT NULL AUTO_INCREMENT PRIMARY KEY , 

'mois' VARCHAR ( 10 ) NOT NULL , 

'temperature' INT NOT NULL 

) 

Remplissons-la ainsi : 

INSERT INTO ' meteo' .' temperature' ( 

'id' , 

'mois' , 

' temperature' 

) 

VALUES ( 



NULL , 


' Janvier' , '0' 


) , ( 
NULL , 


' Fevrier' , ' -5' 


) , ( 
NULL , 


'Mars', '8' 


) , ( 
NULL , 


'Avril', '15' 


) , ( 

NULL , 


'Mai', '15' 


) , ( 

NULL , 


'Juin', '25' 


) , ( 

NULL , 


'Juillet', '30' 


) , ( 

NULL , 


'Aout', '40' 



) , ( 
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NULL , 


' Septembre' 


, ' 25' 


) , ( 

NULL , 


' Octobre' , 


' 20' 


) , ( 

NULL , 


' Novembre' , 


'10' 


) , ( 

NULL , 

) ; 


' Decembre' , 


'5' 



Definir le look final de notre fichier Microsoft Excel 

Maintenant que nous avons des donnees stockees et pretes a l'emploi, nous devons definir 
la maniere par laquelle ces donnees seront organisees dans notre fichier Excel. Nous 
allons done utiliser Microsoft Excel pour faire une maquette. Nous en profiterons pour 
enregistrer une nouvelle macro en meme temps que nous realiserons notre maquette. 

Pour ce faire, nous utiliserons la meme technique qu'avec Microsoft Word ! Lancez 
Microsoft Excel puis, immediatement, selectionnez l'option Nouvelle Macro... du 
sous-menu Macro, lui-meme se trouvant dans le menu Outils. Donnez un nom a votre 
macro, et e'est parti. N'oubliez pas d'arreter l'enregistreur, une fois que vous avez fini. 



3 Microsoft Excel - excel- 6 



^} Fichier Edition AfFfchage Insertion Format Outils Donnees Ferietre 



-10 G I S E 3 3 



MOIS Janvier Fevrier Mars Avril 



TEMPERATURE 



i. ,1 . _ . ji : -| I - i . ■■ ■. ■ -l i - 



Novembre Dacs:f;L?e 



TEMPERATURE 



[■temperature| 



//// 



Fig. 2.4 : Un tableau et un graphique 
Nous nous proposons, sur ce fichier Excel, de faire apparaitre un tableau et un graphique. 
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Recuperer le code Visual Basic de la maquette 

Une fois votre maquette terminee, recuperez dans l'editeur Visual Basic le code de votre 
macro, et reperez quelles instructions permettent de selectionner une cellule et d' ecrire 
dedans. 

Pour selectionner une cellule, le code Visual Basic de notre macro nous propose ceci : 

Range ("B2") .Select 

Et pour ecrire dans une cellule, le code Visual Basic nous propose cela : 

ActiveCell . FormulaRlCl = "MOIS" 

Maintenant que nous le savons, nous allons ecrire une macro qui mettra en evidence 
chacune des constantes Visual Basic que nous allons utiliser dans PHP : 

Sub constante ( ) 

' constante Macro 

' Macro enregistree le 11/11/2007 par Redfish 



Range ("Al" ) . Select 
ActiveCell . FormulaRlCl 
Range ("A2" ) . Select 
ActiveCell . FormulaRlCl 

End Sub 

Cette macro va ecrire "xl Ri ght" dans la cellule Al, et le contenu de la constante xl Ri ght 
dans la cellule A2. II nous faut encore completer cette macro avec toutes les constantes 
que nous allons utiliser pour rediger notre fichier PHP. 

Commencer le fichier PHP 

A present, nous avons tout le materiel pour demarrer la redaction de notre fichier PHP. 
Toujours dans votre repertoire chap02, creez un fichier com_excel.php et remplissez-le 
comme suit : 

com_excel.php 

<?php 

$conn=mysql connect ( ' localhost' , ' root' , ' ' ) 



= "xlRight" 
= xlRight 
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or die ( ' Probleme lors de la connexion a MYSQL'); 
mysql_select_db ( ' meteo' , $conn ) 

or die (' Probleme lors de la selection de la base de donnees'); 
$query="SELECT * FROM 'temperature' "; 
$res=mysql_query ($query) 

or die (' Probleme lors de la reception des enregistrements' ) ; 

$i = 1; 

while ($tableau = mysql_f etch_array ( $res ) ) { 
$i + + ; 

echo $tableau [ ' mois' ] . " :: ". $tableau [' temperature' ]. "<br/>" ; 

} 

?> 

Ce fichier se contente d'aller chercher les donnees dans la base puis de les afficher sur 
notre page web. 

Ouvrir et fermer une instance de l'application Microsoft Excel 

II va nous falloir ouvrir une instance de Microsoft Excel. Copiez ces lignes au tout debut 
de votre fichier com_excel.php : 

$excel=new COM ( "Excel . application" ) 

or die ( "Impossible d'instancier l'application Excel . <br/>" ) ; 

Lorsque nous aurons effectue toutes les operations necessaires, nous devrons fermer 
1' instance de Excel. Pour ce faire, copiez ces lignes a la toute fin de votre fichier : 

$excel->Quit ( ) ; 
$excel = null; 

Travailler sur des feuilles et des classeurs 

Comme vous le savez surement, un fichier Excel est constitue d'un classeur, lui-meme 
constitue d'une ou plusieurs feuilles. Si, lorsque vous avez enregistre votre macro, vous 
avez fait des operations comme la creation d'un nouveau fichier, d'une nouvelle feuille, 
etc., vous pourrez voir les instructions realisant ces actions dans le code Visual Basic de 
votre macro et les utiliser dans PHP. Sinon, voici ce qu'il faut rajouter dans votre fichier 
com_excel.php : 

$excel=new COM ( "Excel . application" ) 

or die ( "Impossible d'instancier l'application Excel . <br/>" ) ; 

$excel->Wor kbooks->Add ( ) ; //Aj out d'un classeur 
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$book=$excel->Workbooks ( 1 ) ; // $book contient le classeur actif 
$sheet=$book->Worksheets ( 1 );//$ sheet contient la feuille active 
$sheet->Name = "Temperature" ; //Attribution d' un nom a la feuille 

En procedant de cette maniere, le classeur ($book) et la feuille ($sheet) seront toujours 
a portee de main... 

Sauvegarder le fichier 

Comme nous allons tester de nombreuses fois notre fichier au fur et a mesure de sa 
creation, autant ecrire les instructions de sauvegarde et, pourquoi pas, rajouter un petit 
lien pointant vers le fichier Excel que com_excel.php aura cree. Modifiez votre code de 
la maniere suivante : 

$fichier = "D:\dynamisez PHP\chap02\excel.xls"; 

$book->SaveAs ($f ichier ) ; //Enregistrement du document 
$sheet = null; 
$book = null; 

$excel->Wor kbooks->Close ( ) ; //Fermeture du classeur 
$excel->Quit ( ) ; 
$excel = null; 

echo "Telechargez votre <a href =' excel . xls ' >fichier</a>" ; 



Nous en profitons pour ajouter des lignes liberant les ressources occupees par $sheet et 
$book. 

Realiser l'en-tete du tableau 

Si vous testez votre travail des maintenant, le fichier excel.xls se trouvera bien la ou vous 
le souhaitiez. Maintenant, commencons a le remplir. L'en-tete de notre tableau, seul 
element non dynamique, semble etre un bon choix pour demarrer. Completez done 
com_excel.php ainsi : 



$cell=$sheet->Range ('B2' ) 
$cell->FormulaRlCl="MOIS" 
$cell=$sheet->Range ( ' B3' ) 
$cell->FormulaRlCl=" TEMPERATURE" 



// selection de la cellule 
/ / ecrire dans la cellule 



$i = 1; 

while ($tableau = mysql_f etch_array ( $res ) ) { 
$i + + ; 

echo $tableau [ ' mois' ] • " "• $tableau [' temperature' ]. "<br/>" ; 

} 
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E Microsoft Excel - excel. kIs 
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Fig. 2.5 : 

C'est un bon debut ! 



Vous pouvez tester votre travail. Et en profiter pour noter un leger souci : si par hasard 
le fichier excel.xls devait deja exister, votre serveur moulinera sans generer le nouveau 
fichier. Voici done comment eviter ce probleme : 

$fichier = "D:\dynamisez PHP\chap02\excel.xls"; 



if ( f ile_exists ( "excel . xls " ) ) 
unlink ( "excel . xls" ) ; 

$book->SaveAs ( $f ichier ) ; / /Enregistrement du document 



Remplir le tableau avec les donnees de la base 

Comme vous l'avez tres justement devine, c'est dans la boucle whi le de notre code que 
cela va se passer : 

$i = ord("B") ; 

while ($tableau = mysql_f etch_array ( $res ) ) { 
$i + + ; 

echo $tableau [ ' mois' ] • " "• $tableau [' temperature' ]. "<br/>" ; 
$cellSelected = chr ( $i ) . "2 " ; 
$cell=$sheet->Range ( $cellSelected) ; 
$cell->FormulaRlCl=$tableau ['mois' ] ; 
$cellSelected = chr ( $i ) . "3 " ; 
$cell=$sheet->Range ( $cellSelected) ; 
$cell->FormulaRlCl=$tableau [' temperature' ] ; 

} 

Comme l'adresse de chaque cellule est definie par un couple lettre/nombre, et que nous 
allongeons notre tableau horizontalement, il va nous falloir incrementer la partie "lettre" 
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de ce systeme d'adressage. Pour cela, nous allons utiliser les fonctions ord() et chr(), qui 
permettent de connaitre le code ASCII d'un caractere ou inversement, le caractere lie a 
un code ASCII. 

Comme la toute premiere cellule que nous allons manipuler au sein de la boucle while 
se trouve dans la colonne C, nous allons initialiser notre variable $i a 
ord("B") (c'est-a-dire 66). La premiere instruction de la boucle est d'incrementer $i : le 
reste de la boucle travaillera alors avec le bon contenu de variable. 



Donner du style 

Commencons par l'en-tete. Voici ce que nous indique le code Visual Basic : 



Range ("B2 :B3") .Select 




Selection. ColumnWidth = 14.29 




Selection . Font . Bold = True 




Et voici son pendant PHP : 


//Style de l'en-tete 




// Selectionner les cellules de l'en- 


tete 


$cell = $sheet->Range ("B2:B3") ; 




//elargir la selection 




$cell->ColumnWidth = 14.29; 




//passer le texte de la selection en 


gras 


$cell->Font->Bold = true; 




//aligner le texte de la selection a 


droite 


$cell->HorizontalAlignment = -4152; 




// mettre le fond de la selection en 


gris 


$cell->Interior->Color Index = 15; 





Ce code est, bien entendu, a ecrire apres que le tableau ait ete rempli, soit juste apres la 
boucle whi 1 e. 

Nous allons maintenant centrer le contenu de toutes les cellules de notre tableau (sauf 
celles de l'en-tete), et reduire un peu leur largeur : 

//centrer les cellules du tableau 

// Selectionner les cellules a centrer 

$cell = $sheet->Range (' C2 : ' . chr ($i) . ' 3' ) ; 

$cell->HorizontalAlignment = -4108; 

// retrecir la taille (largeur) de la selection 

$cell->ColumnWidth = 8.5; 

II ne vous reste plus qu'a faire apparaitre les cadres : 
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// selectionner 1' ensemble du tableau 

$cell = $sheet->range (' B2 : ' . chr ($i) . ' 3' ) ; 

//Appliquer une bordure autour de la selection, 

// sur les 4 cotes 

for($a = 7 ; $a <= 10 ; $a++) { 

// Selectionner le bon cote de la cellule 

$bordure = $cell->Border s ( $a ) ; 

$bordure->LineStyle = 1; 

$bordure->Weight = -4138; 

} 

// Mettre des bordures a 1' interieur de la selection 
for($a = 11 ; $a <= 12 ; $a++) { 

// Selectionner le bon cote de la cellule 

$bordure = $cell->Border s ( $a ) ; 

$bordure->LineStyle = 1; 

$bordure->Weight = 2; 

} 

$bordure = null ; 
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► Fig. 2.6 : Un magnifique tableau 

Ajouter un graphique 

Eh oui ! Que serait Microsoft Excel sans les graphiques ! Regardons tout de suite dans 
notre macro comment Visual Basic s'y prend : 

Charts. Add 

ActiveChart . ChartType = xlColumnClustered 
ActiveChart . SetSourceData 
Source:=Sheets ("Temperature "). Range ( "B2 : N3" ) , PlotBy:= 
xlRows 

ActiveChart .Location Where : =xlLocationAsOb j ect , Name : =" Temperature" 
ActiveSheet . Shapes ( "Graphique 1 " ) . IncrementLef t -89.25 
ActiveSheet . Shapes ( "Graphique 1 " ) . IncrementTop -113.25 
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ActiveSheet . Shapes ( "Graphique 1 " ) . ScaleWidth 1.14, msoFalse, 
msoScaleFromTopLef t 

Et voici comment nous l'interpretons avec PHP : 

//Aj outer un graphique 
$graphique = $book->Charts->Add ( ) ; 
$graphique->ChartType =51; // histogramme 
//Selection des sources du graphique : 
$sourceGraphique = $sheet->range ( ' B2 : ' . chr ( $i ) . ' 3' ) ; 
$graphique->SetSourceData ($sourceGraphique, 1) ; 
$sourceGraphique = null; 

// Definir le graphique comme faisant partie 
// de la feuille "Temperature" 
$graphique->Location (2, "Temperature"); 
// deplacer et dimensionner le graphique 
$forme = $ sheet->Shapes ( "Graphique 1"); 
$forme->IncrementLeft (-89.25) ; 
$f orme->IncrementTop (-113 .25) ; 
$f orme->ScaleWidth (1 . 14, 0, 0); 
$forme = null; 
$graphique = null ; 

Votre fichier Excel est d'ores et deja termine, avec son tableau et son graphique ; il est 
pret a l'emploi. 

(J) Pensez d I i be re r la memoire 

Lorsque Ton utilise COM pour creer des documents Microsoft Office, les variables que nous creons pour 
cela - telles que $excel ou Sgraphique - sont tres gourmandes en memoire. N'oubliez done pas de la 
liberer des que vous n'en avez plus besoin en assignant la valeur null ou en utilisant la fonction 
unset() . 

Terminons ce passage sur COM par le code complet du fichier com_excel.php : 

&q com_excel.php 

<?php 

$excel=new COM ( "Excel . application" ) 

or die ( "Impossible d'instancier 1' application Excel . <br/>" ) ; 

$excel->Workbooks->Add ( ) ; //Aj out d' un classeur 

$book=$excel->Workbooks ( 1 ) ; // $book contient le classeur actif 
$sheet=$book->Worksheets ( 1 );//$ sheet contient la feuille active 
$sheet->Name = "Temperature" ; //Attribution d' un nom a la feuille 



B7 



2 Utiliser la bureautique 



$conn=mysql connect ( ' localhost' , ' root' , ' ' ) 

or die (' Probleme lors de la connexion a MYSQL'); 

mysql_select_db ( ' meteo' , $conn ) 

or die (' Probleme lors de la selection de la base de donnees' ) ; 

$query="SELECT * FROM 'temperature' " ; 

$res=mysql_query ($query) 

or die (' Probleme lors de la reception des enregistrements' ) ; 

$cell=$ sheet->Range ( ' B2 ' ) ; // selection de la cellule 
$cell->FormulaRlCl = "MOIS" ; // ecrire dans la cellule 
$cell=$sheet->Range ( ' B3' ) ; 
$cell->FormulaRlCl=" TEMPERATURE" ; 

$i = ord ("B") ; 

while ($tableau = mysql_f etch_array ( $res ) ) { 
$i++; 

echo $tableau [ 'mois' ] . " :: ". $tableau [' temperature' ]. "<br/>" ; 

$cellSelected = chr ( $i ) . "2 " ; 

$cell=$sheet->Range ( $cellSelected) ; 

$cell->FormulaRlCl=$tableau ['mois' ] ; 

$cellSelected = chr ( $i ) . "3 " ; 

$cell=$sheet->Range ( $cellSelected) ; 

$cell->FormulaRlCl=$ tableau [ ' temperature ' ] ; 

} 

//Style de l'en-tete 

// Selectionner les cellules de l'en-tete 
$cell = $sheet->Range ("B2 :B3") ; 
//elargir la selection 
$cell->ColumnWidth = 14.29; 
//passer le texte de la selection en gras 
$cell->Font->Bold = true; 

//aligner le texte de la selection a droite 
$cell->HorizontalAlignment = -4152; 
// mettre le fond de la selection en gris 
$cell->Interior->Color Index = 15; 

//centrer les cellules du tableau 

// Selectionner les cellules a centrer 

$cell = $sheet->Range ( ' C2 : ' . chr ( $i ) . ' 3' ) ; 

$cell->HorizontalAlignment = -4108; 

// retrecir la taille (largeur) de la selection 

$cell->ColumnWidth = 8.5; 

// selectionner 1' ensemble du tableau 
$cell = $sheet->range (' B2 : ' . chr ($i) . ' 3' ) ; 
//Appliquer une bordure autour de la selection, 
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/ / sur les 4 cotes 

for($a = 7 ; $a <= 10 ; $a++) { 

// Selectionner le bon cote de la cellule 

$bordure = $cell->Border s ( $a ) ; 

$bordure->LineStyle = 1; 

$bordure->Weight = -4138; 

} 

// Mettre des bordures a l'interieur de la selection 
for($a = 11 ; $a <= 12 ; $a++) { 

// Selectionner le bon cote de la cellule 

$bordure = $cell->Border s ( $a ) ; 

$bordure->LineStyle = 1; 

$bordure->Weight = 2; 

} 

$bordure = null; 

//Ajouter un graphique 
$graphique = $book->Charts->Add ( ) ; 
$graphique->ChartType =51; // histogramme 
//Selection des sources du graphique : 
$sourceGraphique = $sheet->range ( ' B2 : ' . chr ( $i ) . ' 3' ) ; 
$graphique->SetSourceData ( $ sourceGraphique , 1) ; 
$sourceGraphique = null; 

// Definir le graphique comme faisant partie 

// de la feuille "Temperature" 

$graphique->Location (2, "Temperature"); 

// deplacer et dimensionner le graphique 

$forme = $ sheet->Shapes ( "Graphique 1"); 

$f orme->IncrementLef t (-89.25) ; 

$f orme->IncrementTop (-113 .25) ; 

$f orme->ScaleWidth (1 . 14, 0, 0); 

$ forme = null; 

$graphique = null; 

$fichier = "D:\dynamisez PHP\chap02\excel.xls"; 

if ( f ile_exists ( "excel . xls " ) ) 
unlink ( "excel . xls" ) ; 

$book->SaveAs ($f ichier ) ; //Enregistrement du document 
$sheet = null; 
$book = null; 

$excel->Wor kbooks->Close ( ) ; //Fermeture du classeur 
$excel->Quit ( ) ; 
$excel = null; 

echo "Telechargez votre <a href =' excel . xls ' >fichier</a>" ; 
?> 
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2.2 DOM : de XML a OpenOffice.org (OOo) 

Nous allons maintenant voir comment generer des documents OpenOffice.org. Pour cela, 
nous allons utiliser l'extension DOM, qui permet de creer et manipuler des documents 
XML avec PHP, et l'extension ZIP. Mais quel rapport y a-t-il entre ces extensions et les 
fichiers OOo ? Eh bien, un fichier OOo, c'est tout simplement un ensemble de fichiers 
XML compresses en une archive... 

DOM etXML 

DOM (Document Object Model) est une extension de PHP qui nous permet de manipuler 
des fichiers XML. Le but de ce passage n'est pas d'apprendre a utiliser DOM ou XML, 
mais comme nous en aurons besoin pour arranger quelques fichiers, autant faire le tour 
de quelques fonctions importantes. 

(£) XML et PHP k 

DOM ne fonctionne, pour le moment, qu'avec PHP5. Si vous ne disposez que de PHP4, vous pouvez 
utiliser en lieu et place l'extension DOM XML. 

Eventuellement, vous pouvez aussi utiliser l'extension SimpleXML pour manipuler des fichiers XML. 
Comme son nom I'indique, SimpleXML est tres simple d'utilisation mais, en contrepartie, ne permet pas 
autant de choses que DOM. 

Commencons done, dans notre repertoire chap02, par creer le fichier domjtest.xml : 

dom_test.xml 

<?xml ver sion=" 1 . " encoding="utf-8 " ?> 
<animaux> 

<famille nom="oiseau"> 
<poule> 

La poule domestique (Gallus gallus domesticus) 

est un oiseau de l'ordre des gallif ormes . 
</poule> 
<pigeon> 

Les pigeons (genre Columba) sont des oiseaux de 
la famille des Columbidae . 
</pigeon> 
</f amille> 
<famille nom="poisson"> 
<hareng> 

Le hareng (Clupea harengus) est un poisson vivant 
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en grands bancs . 
</hareng> 
</f amille> 
</ animaux> 

Ouvrir un fichier XML et recuperer le noeud racine 

Toujours dans le repertoire chap02, creez un fichier nomme domjtest.php et remplissez-le 
comme suit : 

dom_test.php 

<?php 

$dom = new DomDocument ( ) ; 
$dom->load ( ' dom test.xml'); 

// Recuperer la racine 
$animaux = $dom->f irstChild; 

echo "<b>noeud racine : </b>" . $animaux->tagName ; 

echo "<br/>"; 

?> 

L'objet DomDocument est l'objet de base. II represente un document XML dans son 
integralite. C'est d'ailleurs a partir de cet objet que nous chargeons notre fichier XML, via 
la methode DomDocument: :load(). 

Pour recuperer le nceud racine de notre document, nous allons utiliser la propriete 
firstChild de l'objet DomDocument. Cette propriete renvoie le premier nceud enfant sous 
la forme d'un objet DomNode. 

Dans notre exemple, la variable $animaux contient l'integralite du nceud <animaux>, 
enfants compris. 

Cet objet DomNode dispose d'une propriete tagName qui renvoie, sous la forme d'une 
chaine de caracteres, le nom de notre balise. 

Obtenir une liste de noeuds grace au nom des balises 

L'extension DOM nous permet de faire une recherche de nceuds dans l'integralite d'un 
document, et ce a partir d'un nom de balise. Completez done le fichier dom_test.php par 
le code suivant : 

// Obtenir une liste de noeuds par leur nom 
$listeFamille = $dom->getElementsByTagName ( ' f amille' ) ; 
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Nous utilisons la variable $dom, c'est-a-dire l'objet DomDocument contenant l'integralite de 
notre document XML, afin de faire une recherche dans l'ensemble du document, sans 
s'occuper de la hierarchie des elements. 

La methode DomDocument: : getEl ementsByTagName() recherche dans tout le document les 
noeuds dont le nom de balise est "f ami lie". Elle renvoie le resultat sous la forme d'un 
objet DomNodeLi st. 

/j\ Une liste n'est pas un tableau 

L'objet DomNodeLi st n'est pas un tableau. II est hors de question d'acceder au contenu de cette objet par 
une syntaxe d crochets, done I Pour ce faire, utilisez plutot la methode DomNodeLi st : :index() .. . 

Vous souhaitez connaitre le nombre de resultats renvoyes par la recherche ? 

// Savoir combien il y a de noeuds dans une liste 

echo "noeud racine a <b>" . $ listeFamille->length . "</b> noeuds enfants"; 

II nous suffit d'utiliser la propriete length de l'objet DomNodeLi st. 

Nous allons maintenant passer en revue les noeuds contenus dans $1 i steFami 1 1 e afm d'y 
appliquer un traitement. Nous utilisons a cet effet la structure foreach, bien que d'autres 
solutions soient possibles : 

// Passer en revue les noeuds d' une liste 
echo "<ol>"; 

foreach ($listeFamille as $famille) { 
// obtenir la valeur d'un attribut 

echo "<lixu>" . $f amille->getAttribute ( ' nom' ) . "</uxbr/>" ; 

} 

echo "</ol>"; 

fi===^^= Fig. 2.7 : 
PmSUU^S^B Un bon debut 

Fichier Edition Affichage Historique M. 
^ monok 

noeud racine : animaux 
noeud racine a 2 noeuds enfants 

1. oiseau 

2. poisson 
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Vous pouvez noter l'usage de la methode DomNode: :getAttri bute() qui nous permet de 
recuperer, sous la forme d'une chaine de caracteres, le contenu d'un des attributs du 
noeud, en 1' occurrence, le nom de la famille. 

Passer en revue les enfants d'un noeud 

Nous allons maintenant verifier la presence (ou non) d'eventuels enfants au sein de 
chaque famille, puis les lister. Modifions notre code ainsi : 

f oreach ($listeFamille as $famille) { 
// obtenir la valeur d'un attribut 

echo "<lixu>" . $f amille->getAttribute ( ' nom' ) . "</uxbr/>" ; 

// Verifier si chaque famille dispose d' enfants 
if ( ! $famille->hasChildNodes () ) { 

echo "Cette famille n'a pas d' enf ants<br />" ; 

} else { 

// futurs traitements 

} 

} 

La methode DomNode: :hasChi ldNodes(), comme son nom l'indique, renvoie un booleen 
permettant de savoir si notre noeud dispose d'enfants. 

Continuons sur notre lancee et appliquons un traitement aux eventuels enfants de chaque 
famille. Completez le bloc else de la maniere suivante : 

else { 

/ / recuperer le premier noeud enfant 
$animal = $f amille->f irstChild; 

//Passer en revue les noeuds d'une liste 
//sans en connaitre les noms 
echo "<ul>"; 
while ($animal) { 

// verifie qu'il s'agit bien d'un DOMElement 
if ( $animal->nodeType == 1) { 

echo "<lixb>" . $animal->tagName . "</bxbr/>" ; 

echo utf8 decode ( $animal->fir stChild->nodeValue ) ; 

} 

/ / avancer au noeud suivant 
$animal = $animal->nextSibling; 

} 
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echo "</ul>"; 

} 

La premiere chose a faire est de recuperer le premier enfant d'une famille. A ce titre, nous 
utilisons la propriete firstChild de l'objet DomNode. 



(j) Methodes homonymes 

Nous avons deja utilise la propriete f i rstChi 1 d, mais avec l'objet DomDocument. Faites attention de bien 
savoir quel objet vous etes en train de manipuler, car si les objets DomDocument et DomNode disposent de 
proprietes et de methodes homonymes, elles ne renvoient pas forcement les memes choses I 

Ensuite, nous verifions le type du noeud auquel nous avons affaire, en utilisant la propriete 
nodeType de l'objet DomNode. En effet, nous ne cherchons a avoir affaire qu'avec des 
noeuds elements, quand un noeud peut etre un attribut ou du texte. 

Si notre noeud est bien du type voulu, nous affichons son nom de balise qui, dans notre 
exemple, represente aussi le nom de l'animal, grace a la propriete tagName. 

Nous allons aussi afficher le petit texte contenu par ce noeud. Pour cela, nous devons 
d'abord atteindre le premier enfant de notre noeud. En effet, le texte est considere comme 
etant un noeud texte. Ensuite, la propriete nodeVal ue renvoie le contenu de notre noeud 
texte sous forme de chaine de caracteres. 

Enfin, nous passons d'un noeud a l'autre grace a la propriete nextSibl ing. Cette derniere 
renvoie le noeud suivant, ou null s'il n'y en a pas. 



^ Mozilla Firefox 



Fichier Edition Affichage Historique Marque-pages Outils 



- __. - 1^ ^ | □ hl=l=p://l QcalhQ5l=/dynarni5ez%20PHP/chap02/dQrnJe5l=,php 



monok 



noeud raciiie : animaux 
noeud racine a 2 noeuds enfants 



1. oiseau 



La poule domestique (Gallus gallus domesticus) est un oiseau de l'ordre des galliformes. 
pigeon 

Les pigeons (genre Columba) sont des oiseaux de la faniille des Columbidae. 
2. poisson 

hareng 

Le hareng (Clupea harengus) est un poisson vivant en grands bancs. 



Fig. 2.8 : Tout est affiche. 
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Voici le code complet du fichier dom_test.php : 



dom_test.php 

<?php 

$dom = new DomDocument ( ) ; 
$dom->load ( ' dom_test . semi ' ) ; 

// Recuperer la racine 
$animaux = $dom->f irstChild; 

echo "<b>noeud racine : </b>" . $animaux->tagName; 
echo "<br/>"; 

// Obtenir une liste de noeuds par leur nom 
$listeFamille = $dom->getElementsByTagName (' f amille' ) ; 

// Savoir combien il y a de noeuds dans une liste 

echo "noeud racine a <b>" . $listeFamille->length. "</b> noeuds enfants"; 
echo "<br/>"; 

// Passer en revue les noeuds d' une liste 
echo "<ol>"; 

foreach ($listeFamille as $ f amille ) { 
// obtenir la valeur d' un attribut 

echo "<lixu>" . $f amille->getAttribute ( ' nom' ) . "</uxbr/>"; 

// Verifier si chaque f amille dispose d' enfants 
if ( ! $famille->hasChildNodes () ) { 

echo "Cette f amille n'a pas d' enf ants<br />" ; 

} else { 

/ / recuperer le premier noeud enfant 
$animal = $famille->f irstChild; 

//Passer en revue les noeuds d' une liste 
//sans en connaitre les noms 
echo "<ul>"; 
while ($animal) { 

// verifie qu'il s'agit bien d' un DOMElement 
if ( $animal->nodeType == 1) { 

echo "<lixb>" . $animal->tagName . "</bxbr/>" ; 

echo utf8 decode ( $animal->fir stChild->nodeValue ) ; 

} 

// avancer au noeud suivant 
$animal = $animal->nextSibling; 

} 

echo "</ul>"; 
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} 

} 

echo "</ol>"; 
?> 

Aj outer un noeud 

Avec DOM, lorsque vous souhaitez ajouter un noeud a un document XML, il vous faut 
d'abord le creer. Demarrons un nouveau fichier PHP que nous appellerons dom_ajouter 
.php, et remplissons-le de la maniere suivante : 

J^jt dom_ajouter.php 

<?php 

$dom = new DomDocument ( ) ; 
$dom->load ( ' dom test.xml'); 

// creer le noeud sans 1' ajouter a l'arbre XML 
$nouvelleFamille = $dom->createElement ( "f amille" ) ; 

// creer un attribut "nom" a ce noeud 
// et lui attribuer une valeur 

$nouvelleFamille->setAttribute ( "nom" , "reptile") 
?> 

L'objet DomDocument dispose de la methode DomDocument: :createElement(), qui permet 
de creer, en memoire seulement, un nouveau nceud. Dans notre exemple, nous creons un 
nouveau nceud "f ami 1 1 e". 

La methode DomElement: : setAttri bute() ajoute un attribut a l'element. Le premier 
parametre de cette methode indique le nom de 1' attribut, et le second indique la valeur de 
cet attribut. 

Le nceud que nous venons de creer ressemble a cela : 

<famille nom="reptile" /> 

Pour le moment, notre nceud ne dispose pas d'enfants. Corrigeons cela. Rajoutez, a la fin 
de dom_ajouter.php, le code suivant : 

//creer le nouveau noeud "animal" 
$nouvelAnimal = $dom->createElement (" serpent ") ; 

$desc = "Les serpents (sous-ordre des Serpentes) " . 
"sont des reptiles au corps cylindrique " . 
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"et allonge, depourvus de membres apparents." . 
" lis partagent cette derniere caracteristique" . 
" avec un groupe de vertebres " . 

"tetrapodes : les gymnophiones , qui appartiennent" . 
" au groupe des lissamphibiens."; 

//creer le DOMText de description 
$description = $dom->createTextNode ( $desc ) ; 

// a j outer le noeud texte au noeud $nouvelAnimal 
$nouvelAnimal->appendChild ( $description) ; 

// a j outer le noeud $nouvelAnimal 
// au noeud $nouvelleFamille 

$nouvelleFamille->appendChild ( $nouvelAnimal ) ; 

Nous faisons appel a deux nouvelles methodes. Tout d'abord la methode 
DomDocument: :createTextNode() qui, comme son nom l'indique, va creer un nouveau 
noeud de type texte. Ce nouveau noeud n'est encore relie a rien, et surtout pas a notre 
document. 

La seconde methode, DomEl ement : :appendChi 1 d(), permet enfin de Her un noeud a un 
autre. Dans notre exemple, le noeud $nouvel Animal devient un enfant du noeud 
$nouvel 1 eFami 1 1 e. Voici a quoi ressemble maintenant le noeud $nouvel 1 eFami 1 1 e : 

<famille nom="reptile"> 
<serpent> 

Les serpents (sous-ordre des Serpentes ) ... 
...au groupe des lissamphibiens. 
</ serpent> 
</f amille> 

Passons maintenant a la derniere etape : lier notre nouveau noeud a notre document. Pour 
ce faire, nous allons utiliser encore une fois la methode DomEl ement: :appendChi ld(), 
mais nous allons l'appliquer depuis le noeud de notre document que nous souhaitons voir 
completer. Ainsi, dans notre exemple, nous creons un noeud "f ami lie" qui doit s'ajouter 
a la suite des autres noeuds "f ami 1 1 e" de notre document. Ces noeuds sont des enfants du 
noeud racine, "animaux". Nous allons done commencer par isoler le noeud racine, puis lui 
ajouter un nouvel enfant. Voici done les quelques lignes a rajouter a dom_ajouter.php : 

// Recuperer la racine 
$animaux = $dom->f irstChild; 

// ajouter le noeud $nouvelleFamille 
// au noeud $animaux 

$animaux->appendChild ( $nouvelleFamille ) ; 
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// on n' oublie pas de sauvegarder notre document modifie : 
$dom->save (' dom test .xml' ) ; 



Et voila ! N'oubliez pas d'utiliser la methode DomDocument: :save() pour sauvegarder vos 
modifications dans le fichier domjtest.xml. 



Mozilla Firefox 



Fichier Edition Affichage Hi5torique Marque-pages Outils ? 



■ N _ - http://locdlhost/dynamisez%20PHP/chap02/dom_test.php 



noeiul 1 >v: uie anilnaux 
noeud ratine a noeuds infants 



* pmuje 

La poule domestique (Gallus gallus domesticus) est un oiseau de l'ordre des galliformes. 
° pigeon 

Lr. | . - Ii. ' .Tlur .' I'M . Ill Ir. l.r.i'.. Ir I. . Qiullr . : '.' I'll . i l.ir 

2. poisson 

° hareng 

Le hareng (Clupea haretigus) est un poisson vivant en grands bancs. 

3. reptile 

° serpen! 

les serpents (sous-ordre des Serpentes) sont des reptiles au corps cylindrique et allonge, depourvus de i 
vertebres tetrapodes : les gymnophiones, qui appartiennent au groupe des lissamphibiens. 



► Fig. 2.9 : Un nceud de plus 

Vous pourrez voir les modifications en ouvrant le fichier domjtest.php avec votre 
navigateur prefere. 

Effacer un noeud 

Nous venons de creer un nouveau noeud "fami lie". A present, nous allons l'effacer. Pour 
ce faire, creez un nouveau fichier, dom_effacer.php, et remplissez-le comme suit : 



Off, dom_effacer.php 

<?php 

//ouvrir le fichier content. xml 
$dom = new DomDocument ( ) ; 
$dom->load ( ' dom_test . xml' ) ; 
$animaux = $dom->f irstChild; 

// obtenir la liste des noeuds "famille" 
$listeFamille = $dom->getElementsByTagName (' famille' ) ; 



// isoler le noeud "reptile" 
$reptile = null; 
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foreach ($listeFamille as $famille) { 

if ( $f amille->getAttribute ( ' nom' ) == ' reptile' ){ 
$reptile = $famille; 
break; 

} 

} 

// ef facer le noeud $reptile 
$animaux->removeChild ( $reptile) ; 

$dom->save ( ' dom test.xml'); 
?> 

II n'y a rien de bien complique : on commence par isoler dans une variable le noeud que 
Ton souhaite supprimer, ainsi que son noeud parent. Ensuite, grace a la methode 
DomNode: :removeChild(), on le supprime purement et simplement. 

XML et OOo 

Le fichier OOo Writer que nous allons creer ensemble va presenter les informations 
contenues dans le fichier domjtest.xml. Comme nous l'avons deja fait pour creer des 
documents Microsoft Office, nous allons partir d'une maquette. 

Ouvrez OOo Writer et faites une maquette. 



it ftwrflSf fJjicrOffin:.nr K Wrilcr |_J|Hj|Xj 



I cher L^ten if chagt Insertion I ornat Int4e«j fjutis itnetre fu&f 

I B • e? ■ a lISll B &• X -fc • • * * ■ e> - # ■ • H«ii 1 4 <9 , 




Fig. 2.1 : Notre maquette OOo Writer 



73 



2 Utiliser la bureautique 



Enregistrez votre maquette sous le nom famille.odt, dans votre repertoire chap02. 

Vous allez maintenant ouvrir ce nchier avec un logiciel de type Winrar ou 7-Zip, et en 
extraire le contenu. 



Comme vous pouvez le constater, nous n'avons ici que des documents XML. 
Rassurez-vous, nous n' allons pas tous les modifier. Nous nous contenterons de manipuler 
le nchier content.xml. Vous pouvez done copier ce nchier dans votre repertoire chap02, 
et effacer tous les autres. 

Ouvrez maintenant content.xml. Voici comment se presente son architecture : 

content.xml 

<of f ice : document-content> 

<office:scripts/> 

<of f ice : f ont-f ace-decls> 
</ office : f on t-face-decls> 

<of f ice : automat ic-styles> 
</office: automat ic-styles> 

<of f ice : body> 

<of f ice : text> 

<of f ice: forms/> 

<text : sequence-decls> 
</ text : sequence-decls> 

<text : p></ text : p> 
<text : p></ text : p> 
<text : p></ text : p> 

</office: text> 





Fig. 2.11 : 




Le contenu de I'archive 
famille.odt 
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</ office : body> 
</ office : document-content> 

L'espace de noms 

Dans ce fichier, la premiere chose que Ton remarque, ce sont les noms des balises. 

En effet, les noms de balises sont composes de deux mots separes par le signe Le 
premier mot represente ce que Ton appelle l'espace de noms. Ce mot lie chacune des 
balises avec une definition xmlns (toutes ces definitions sont ecrites sous la forme 
d'attributs du nceud racine). 

Le second mot represente tout simplement le nom de la balise. 

C'est une specificite qu'il nous faudra prendre en compte lorsque nous modifierons ce 
fichier. Ainsi, lorsque nous souhaitons creer un nouveau noeud, nous n'utiliserons pas la 
methode DomDocument: :createElement() , mais la methode DomDocument: : create 
ElementNS(). Voici un exemple : 

$nouveauNoeudNS = $dom->createElementNS ( ' text' , 'p'); 
//cree un noeud 
//<text:p /> 

Le premier argument de la methode indique l'espace de noms, et le second indique le nom. 



Creer un fichier OOo Writer avec DOM et PHP 

Toujours dans notre fichier content. xml, nous allons tenter de reperer ou a ete place le 
contenu. Vous l'avez trouve ? 



<text 


P 


text 


style- 


name= 


"PI ">Famille</ text : p> 




<text 


P 


text 


style- 


name= 


"P3">nomAnimal</text :p> 




<text 


P 


text 


style- 


name= 


ii P2 ">DescriptionAnimal</ text 


P> 


<text 


P 


text 


style- 


name= 


"P4"> </text :p> 




<text 


P 


text 


style- 


name= 


"P3">nomAnimal</text :p> 




<text 


P 


text 


style- 


name= 


"P2">DescriptionAnimal</text 


P> 


<text 


P 


text 


style- 


name= 


"Standard"/> 




<text 


P 


text 


style- 


name= 


"Pl">Famille</text :p> 





II s'agit des balises "p" appartenant a l'espace de noms "text". Notez que chacune des ces 
balises contient un attribut "text : styl e-name". Cet attribut indique le style du texte, 
c'est-a-dire sa police de caracteres, son alignement, etc. 

Nous allons, dans un nouveau fichier PHP, commencer par effacer toutes ces balises, puis 
les remplacer par de nouvelles, contenant les informations de domjtest.xml. 
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Effacer les vieilles balises 

Toujours dans votre repertoire chap02, creez le fichier ooojwriter.php, et remplissez-le de 
la maniere suivante : 

ooo_writer.php 

<?php 

//ouvrir le fichier content. xml 
$dom = new DomDocument ( ) ; 
$dom->load ( ' content . xml' ) ; 

$racine = $dom->f ir stChild; 

// l'espace de nom "text" 

$ns = "urn : oasis : names : tc : opendocument : xmlns : text : 1 . " ; 

// recuperer la liste des noeuds appartenant au 
// name systeme $ns et dont le nom du tag est "p" 
$listeTextp = $dom->getElementsByTagNameNS ($ns, 'p'); 

// recuperer la liste des noeuds dont 
// le nom du tag est "text" (<of f ice : text>) 
$li = $dom->getElementsByTagName ( ' text' ) ; 
$off = null; // contiendra le seul noeud de ce type 
foreach ($li as $1) { 
$off = $1; 

} 

// effacer les anciens noeuds <text:p> 
while ($listeTextp->length > 0){ 

$of f->removeChild($listeTextp->item(0) ) ; 

} 

?> 

Vous remarquez que nous creons une variable $ns contenant une drole d'adresse... II 
s'agit de l'espace de nom "text", que nous avons recupere dans notre fichier content.xml 
(l'espace de nom est indique sous la forme d'un attribut dans le noeud racine). 

Comme vous le voyez, il n'y a rien de bien complique, si ce n'est que nous utilisons la 
methode DomDocument: :getElementsByTagNameNS(), au lieu de la methode DomDocument 
: :getElementsByTagName(), qui fonctionne exactement de la meme maniere que la 
methode DomDocument: :createElementNS(). Vous pouvez neanmoins retrouver vos 
noeuds sans faire de recherche incluant l'espace de noms ; seulement avec le nom de 
balise. C'est d'ailleurs ce que nous faisons pour retrouver la balise <office:text> (mais 
nous vous le deconseillons). 
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Aj outer les nouvelles balises 

Cela ne devrait pas vous sembler si difficile. Voici comment proceder (rajoutez ce code 
a la fin de ooo_writer.php) : 

// ouvrir le fichier dom test.xml 
OdoraSource = new DomDocument ( ) ; 
$domSource->load ( ' dom test . xral ' ) ; 

/ / recuperer la liste des families 

$listeFamille = $domSource->getElementsByTagName ( ' f ami lie' ) ; 

//chaque famille doit etre traitee : 
f oreach ($listeFamille as $1) { 

// ajouter un noeud pour le "titre" de cette famille 
// dans le document content. xml 
$titreFamille = $ l->getAttribute ( ' nom' ) ; 

$nouveauNoeud = $dom->createElementNS ( $ns , 'p', $titreFamille) ; 
// en se referant a content. xml, on attribue le style PI 
$nouveauNoeud->setAttributeNS ( $ns , 'style-name', 'PI'); 
$of f->appendChild ( $nouveauNoeud) ; 

// recuperer le premier noeud enfant de cette famille 
$animal = $l->f irstChild; 

// traiter tous les noeuds de cette famille 
$noeudAnimal = null; 
while ($animal) { 

// verifie qu'il s'agit bien d' un DOMElement 
if ( $animal->nodeType == 1){ 

// Creer le noeud pour le nom de 1' animal 
$nomAnimal = $animal->tagName; 

$noeudAnimal = $dom->createElementNS ( $ns , ' p' , $nomAnimal); 
// en se referant a content. xml, on attribue le style P3 
$noeudAnimal->setAttributeNS ( $ns , 'style-name', 'P3'); 
$of f->appendChild ( $noeudAnimal ) ; 

/ / Creer le noeud pour la description 
$description = $animal->f irstChild->nodeValue ; 

$noeudAnimal = $dom->createElementNS ( $ns , 'p', $description) ; 
// en se referant a content. xml, on attribue le style P2 
$noeudAnimal->setAttributeNS ( $ns , 'style-name', 'P2'); 
$of f->appendChild ( $noeudAnimal ) ; 

// Creer le noeud " " entre chaque animal 

$noeudAnimal = $dom->createElementNS ( $ns , 'p', ' '); 

// en se referant a content. xml, on attribue le style P4 
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$noeudAnimal->setAttributeNS ($ns, 'style-name', 'P4'); 
$of f->appendChild ( $noeudAnimal ) ; 

} 

$animal = $animal->nextSibling; 

} 

if ( $noeudAnimal != null) { 

$of f->removeChild ( $noeudAnimal ) ; 

} 

// aj outer un noeud pour sauter une ligne 
$nouveauNoeud = $dom->createElementNS ($ns, 'p'); 
$nouveauNoeud->setAttributeNS ($ns, 'style-name', 'Standard'); 
$of f->appendChild ( $nouveauNoeud) ; 

} 

$dom->save ( ' content . xml' ) ; 

II n'y a rien de sorcier, n'est-ce pas ? Nous attirons tout de meme votre attention sur un 
point : 

$noeudAnimal = $dom->createElementNS ( $ns, 'p', $nomAnimal) ; 

Un troisieme argument a ete ajoute a la methode. En fait, cela revient a faire : 

$noeudAnimal = $dom->createElementNS ( $ns, 'p'); 
$noeudTexteAnimal = $dom->createTextNode ( $nomAnimal ) ; 
$noeudAnimal->appendChild ( $noeudTexteAnimal ) ; 

Ajouter le fichier content.xml a l'archive famille.odt 

Maintenant que nous avons refait le fichier content.xml a notre convenance, il ne nous 
reste plus qu'une seule chose a faire : mettre ce fichier dans 1' archive famille.odt, qui 
n'est autre que notre fichier OOo. 

II vous faut ajouter ce code a la fin de votre fichier ooo_writer.php : 



//Sauvegarder en un fichier 


OOo : 




$odt = new ZipArchive; 






if ( $odt->open ( ' f amille . odt' 


, ZIPARCHIVE :: CREATE) = 


=== TRUE) { 


// Ajouter (remplacer) le 


fichier content.xml 




$odt->addFile ( ' content . xml 


', 'content.xml'); 




$odt->close ( ) ; 






echo "ok"; 

} 
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Pour plus de details sur la compression, n 'hesitez pas a vous referer au chapitre 

Compresser c'est gagner... 



# famille OpenOffice.org Writer Q (□][><] 



Fichier Edition 


fiffidhace Ins erf fori l-ormaC Tab! say Oucils heneti-if Aids 
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_a poule domestique (Gallus gallus domesticus) est un oiseau de I'ordre des galliforrnes . 
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poissou 

harem 

_e hareng (Clupea harengus) est un poisson vivant en grands bancs 
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Fig. 2.12: Et voici le resultat final 



Pour conclure ce chapitre, voici le code complet de ooo_writer.php : 



ooo_writer.php 

<?php 

//ouvrir le fichier content. xml 
$dom = new DomDocument ( ) ; 
$dom->load ( ' content . xml' ) ; 

$racine = $dom->f ir stChild; 

// l'espace de nom "text" 

$ns = "urn : oasis : names : tc : opendocument : xmlns : text : 1 . " ; 

// recuperer la liste des noeuds appartenant au 
// name systeme $ns et dont le nom du tag est "p" 
$listeTextp = $dom->getElementsByTagNameNS ( $ns , 'p'); 

// recuperer la liste des noeuds dont 

// le nom du tag est "text" (<of f ice : text>) 
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$li = $dom->getElementsByTagName ( ' text' ) ; 
$off = null; // contiendra le seul noeud de ce type 
foreach ($li as $1) { 
$off = $1; 

} 

// ef facer les anciens noeuds <text:p> 
while ($listeTextp->length > 0){ 

$of f->removeChild($listeTextp->item(0) ) ; 

} 

// on peut commencer a creer de nouveaux noeuds 

// ouvrir le fichier dom test.xml 
$domSource = new DomDocument ( ) ; 
$domSource->load ( ' dom test.xml' ) ; 

//recuperer la liste des families 

$listeFamille = $domSource->getElementsByTagName (' f amille' ) ; 

//chaque f amille doit etre traitee : 
foreach ($listeFamille as $1) { 

// aj outer un noeud pour le "titre" de cette f amille 
// dans le document content. xml 
$titreFamille = $ l->getAttribute ( ' nom' ) ; 

$nouveauNoeud = $dom->createElementNS ($ns, 'p', $titreFamille) ; 
$nouveauNoeud->setAttributeNS ($ns, 'style-name', 'PI'); 
$of f->appendChild ( $nouveauNoeud) ; 

// recuperer le premier noeud enfant de cette f amille 
$animal = $ l->f ir stChild; 

// traiter tous les noeuds de cette f amille 
$noeudAnimal = null; 
while ($animal) { 

// verifie qu'il s'agit bien d' un DOMElement 
if ( $animal->nodeType == 1){ 

// Creer le noeud pour le nom de 1' animal 
$nomAnimal = $animal->tagName ; 

$noeudAnimal = $dom->createElementNS ( $ns , 'p', 
$noeudAnimal->setAttributeNS ($ns, ' style-name' , 
$of f->appendChild ( $noeudAnimal ) ; 

/ / Creer le noeud pour la description 
$description = $animal->f irstChild->nodeValue; 
$noeudAnimal = $dom->createElementNS ( $ns , 'p', $description ) ; 
$noeudAnimal->setAttributeNS ($ns, 'style-name', 'P2'); 



$nomAnimal ) ; 
' P3 ' ) ; 
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$of f->appendChild ( $noeudAnimal ) ; 




// Creer le noeud " " entre chaque animal 

$noeudAnimal = $dom->createElementNS ( $ns , ' p' , 
$noeudAnimal->setAttributeNS ($ns, ' style-name' 

^ nf f-">3nnpnHPh i 1 H f ^nnpuHAni 1 \ • 

^ J_ J_ ^ d k> k> C 1 1 \Jl V L 1 J L \Jl \ V 1 1 W Li LA^ll 1J-1LLCL-L / , 

} 


'— ' ) ; 

, ' P4 ' ) ; 


$animal = $animal->nextSibling; 

} 




if ( $noeudAnimal != null) { 

$of f->removeChild ( $noeudAnimal ) ; 

} 




// a j outer un noeud pour sauter une ligne 
$nouveauNoeud = $dom->createElementNS ( $ns , 'p'); 
$nouveauNoeud->setAttributeNS ( $ns , 'style-name', ' 
$of f->appendChild ( $nouveauNoeud) ; 

} 

$dom->save ( ' content . xml' ) ; 


Standard' ) ; 




//Sauvegarder en un fichier OOo : 
$odt = new ZipArchive; 




if ( $odt->open ( ' f amille . odt' , ZIPARCHIVE : : CREATE ) = 


-== TRUE) { 


// Ajouter (remplacer) le fichier content. xml 
$odt->addFile ( ' content . xml' , ' content . xml' ) ; 
$odt->close ( ) ; 
echo "ok"; 




} 

?> 




2.3 Check-list 



Voici la fin de ce long chapitre consacre a la bureautique. Nous avons vu comment : 

>/ creer un fichier Microsoft Office en utilisant COM ; 
^ creer une maquette et sa macro ; 

^ comprendre le code Visual Basic d'une macro et l'interpreter dans PHP ; 
V utiliser DOM ; 

>/ creer un document OpenOffice.org. 
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Manipuler 
es images 



PHP ne se limite pas d la generation de pages HTML. 
Dans ce chapitre, nous allons voir comment il est 
possible de generer dynamiquement des images dans les 
formats les plus courants sur le Web, d'en creer d partir 
d'images dejd existantes, ou d'en creer d partir de rien... 



3 Manipuler les images 



3.1 GD2 : En toute simplicity 

Nous commencons notre exploration du monde de 1' image facon PHP par GD2, une 
extension qui vous permettra de realiser simplement et rapidement la plupart des taches 
a effectuer sur des images, comme les reduire ou y ecrire une adresse URL. 

Creer une image dynamiquement 

Ann d'aborder simplement GD2, nous allons commencer par voir comment on appelle 
une image deja existante. Creez dans votre editeur favori un nouveau fichier : 
dynamisez_php/chap03/gd.php. A cote de ce fichier, creez un dossier images. Placez une 
image dans ce dossier puis, dans votre fichier gd.php, entrez le code suivant : 

gd.php 

<?php 

header ( "Content-type : image/ j peg" ) ; 

$im = @imagecreatef romjpeg ( "images/ciel2 . j pg" ) 

or die ( "impossible de creer un flux GD2"); 
// remplacez "ciel2.jpg" par le nom de votre image 
imagejpeg ($im) ; 

imagedestroy ($im) ; 

?> 

Lorsque vous ouvrez la page gd.php depuis votre navigateur prefere, votre image apparait 
a l'ecran. Vous pouvez l'enregistrer sur votre disque dur, comme n'importe quelle image 
affichee dans une page web. Vous pouvez aussi faire appel a cette image depuis du code 
HTML. Creez, dans le meme repertoire que votre fichier gd.php, un fichier html_gd.html 
contenant le code suivant : 

^ html_gd.html 

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" 

"http ://www.w3 . org/TR/html4/ strict . dtd"> 
<html> 
<head> 

<meta http-equiv="Content-Type" 
content="text/html; charset=iso-8859-l" /> 
<title>Image GD2</title> 
</head> 
<body> 

<img alt="image dynamique avec GD2" src="gd.php" /> 
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</body> 
</html> 

Lancez le fichier html_gd.html avec votre navigateur : l'image apparait comme telle, alors 
que l'attribut src de la balise img pointe vers un fichier PHP. 

Observons notre code PHP instruction par instruction, arm de decouvrir les rouages de 
base de GD2 : 

header ( "Content-type : image/ jpeg" ) ; 

Cette premiere instruction sert a renseigner l'en-tete de notre fichier gdphp une fois qu'il 
aura ete genere. C'est grace a cet en-tete que votre navigateur interpretera le fichier 
genere comme etant une image. II est necessaire de placer cette instruction avant toute 
autre instruction d'ecriture. 

(J) Les en-tetes Content-type compatibles avec GD2 

Avec GD2, vous pouvez generer autre chose que des imagesJPEG. Remplacez done 1'argument de la 
fonction header() en fonction du type d'image que vous souhaitez obtenir : 

header ( "Content-type : image/ j peg" ) ; // en-tete JPEG 
header ( "Content-type : image/gif " ) ; // en-tete GIF 
header ( "Content-type : image/png"); // en-tete PNG 

header ( "Content-type : image/wbmp" ) ; // en-tete WBMP (attention : la 
plupart des navigateurs ne reconnaissent pas les types WBMP) 

Une fois l'en-tete correctement place, nous chargeons notre image en memoire : 

$im = imagecreatef romjpeg ( "images/ciel2 . jpg" ) ; 

La fonction imagecreatefromjpg() va chercher l'image JPEG de notre choix. Cette 
fonction renvoie un objet de type image que nous stockons dans une variable pour une 
utilisation ulterieure. 

(j) Les autres types d'images 

L'extension GD2 permet de charger d'autres types que leJPEG. Utilisez I'une de ces fonctions selon vos 
besoins : 

// creer la ressource depuis une image GIF. : 
$im = imagecreatef romgif ( "images/ciel2 . gif" ) ; 
// creer la ressource depuis une image PNG : 
$im = imagecreatef rompng ( "images/ciel2 . png 
// creer la ressource depuis une image WBMP : 
$im = imagecreatef romwbmp ( "images/ciel2 . wbmp" ) ; 
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Maintenant que notre image est chargee, il nous faut l'afficher : 

imagejpeg ($im) ; 

II s'agit d'une instruction d'ecriture, c'est-a-dire que c'est ce qui va etre ecrit dans le 
fichier genere par PHP. II faut done imperativement que vous ayez specifie l'en-tete de 
votre image (fonction header ()) avant cette instruction. 



(J) Les autres types d'images 

Comme nous pouvons charger differents types d'images, GD2 nous permet aussi de creer des images 
de differents types : : : 

imagejpeg ($im) // creer une image JPEG 
imagepng ( $im) // creer une image PNG 
imagegif ( $im) // creer une image GIF 
imagewbmp ( $im) // creer une image WBMP 



La toute derniere instruction concerne la destruction de l'image $im : 

imagedestroy ($im) ; 

Cette instruction permet de liberer la memoire utilisee par notre image. En contrepartie, 
nous ne pourrons plus la modifier. 

Fig. 3.1 : 

L'image ciel2.jpg telle 
qu'affichee avec le 
fichier html_gd.html 



^ Image GD2 - MozlLLa Flrefox 



Fichier Edition Affithage Hjstorique Marque-pages Outils 



x _ - - v ' ^ i i http:^localhost/dynamisez%20PHP;chap03;html_gd,html 
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Convertir une image 

Voici comment convertir ses images le plus simplement du monde grace a GD2. Modifiez 
votre fichier gd.php comme suit : 

*fc gd-php 

<?php 

// nous allons renvoyer une image GIF : 
header ( "Content-type : image/gif") ; 

// nous creons notre ressource a partir d'une image JPEG : 
$im = Simagecreatef romjpeg ( "images/ciel2 . jpg" ) 

or die ( "impossible de creer un flux GD2"); 
// nous creons une image GIF : 
imagegif ( $im) ; 
imagedestroy ($im) ; 

?> 

La fonction imagegif () convertit automatiquement notre image de type JPEG en une 
image de type GIF. II en va naturellement de meme pour les autres fonctions. Quel que 
soit le type de notre image, imagejpeg () creera toujours une image JPEG, 
imagepngO une image PNG, etc. 

La seule regie a respecter est l'adequation entre la fonction header () et la fonction 
d'ecriture. 

Scwvegarder une image creee dynamiquement 

La sauvegarde d'images se fait, comme la conversion, grace aux fonctions d'ecriture 
(imagejpegO, imagegif (), imagepngO ...). Nous allons modifier a nouveau notre fichier 
gd.php : 

gd.php 

<?php 

header ( "Content-type : image/ jpeg" ) ; 

$im = @imagecreatef romjpeg ( "images/ciel2 . jpg" ) 

or die ( "impossible de creer un flux GD2"); 
imagejpeg ($im, "images/ciel2_copie . jpg" ) ; 
imagedestroy ($im) ; 

?> 
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La seule difference est l'ajout d'un argument a la fonction imagejpeg () (ou a n'importe 
quelle autre fonction d'ecriture) : une chaine de caractere indique 1' emplacement et le 
nom de 1' image a sauvegarder. 

Lorsque nous lancons dans notre navigateur le fichier html_gd.html, rien ne s'affiche si ce 
n'est le contenu de l'attribut al t de notre balise img. Par contre, le fichier ciel2_copie.jpg 
a bien ete cree dans le repertoire images. En effet, lorsqu'elles ne disposent que d'un seul 
argument, les fonctions d'ecriture ecrivent dans le fichier genere par PHP (dans notre cas, 
1' image est ecrite dans gd.php). Si ces fonctions d'ecriture disposent de deux arguments, 
le flux d'ecriture n'est pas dirige vers le fichier genere, mais vers le fichier image a creer. 

Si nous voulons que notre image soit creee a la fois sur le disque dur et a la fois dans le 
fichier genere, nous avons besoin d'ecrire deux flux dans notre code ; soit deux fonctions 
d'ecriture : 

*fct gd-php 

<?php 

header ( "Content-type : image/ j peg" ) ; 
$im = Simagecreatef romjpeg ( "images/ciel2 . j pg" ) 
or die ( "impossible de creer un flux GD2"); 

// creer 1' image dans le fichier genere 
imagejpeg ($im) ; 

// creer 1' image sur le disque dur 
imagejpeg ($im, "images/ciel2_copie . jpg" ) ; 

imagedestroy ($im) ; 

?> 

Bien entendu, il est possible de creer l'image du fichier genere dans un certain type, et 
de la sauvegarder sur le disque dans un autre. 

3.2 Effectuer des transformations d'images 

Vous voulez pouvoir redimensionner une image ? La faire tourner ? Creer une mosaique ? 
Voici comment proceder en toute simplicite. 
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Redimensionner une image : creation de vignettes 

Nous allons realiser ensemble un script PHP qui realise une copie d'une image en 
reduisant sa taille. Cela peut etre tres utile si Ton veut programmer une galerie avec un 
sy steme de vignettes. 

Commencons done par creer un nouveau fichier (dans le repertoire chap03) que Ton va 
nommer gd_vignette.php et qui va contenir le code suivant : 

gd_vignette.php 

<?php 

function makeVignette ( $grandelmage, $vignette, 

$vignetteLargeurMax, $vignetteHauteurMax) { 

} 

makeVignette (" images/ciel2 . jpg" , "vignettes/ciel2 . j pg" , 50, 50); 
?> 

Comme vous pouvez le voir, nous allons programmer cela sous la forme d'une fonction 
qui sera reutilisable a tout moment. Cette fonction dispose de quatre arguments : le 
premier indique la ou se trouve 1' image originale, et le deuxieme ou sauver notre vignette. 
Les troisieme et quatrieme arguments fixent la largeur et la hauteur maximales de la 
vignette. Dans notre exemple, les images originales seront stockees dans un repertoire 
images, et les vignettes dans un repertoire vignettes. 

Nous pouvons d'ores et deja recuperer les dimensions de l'image originale et creer l'objet 
image : 

gd_vignette.php 

<?php 

function makeVignette ( $grandelmage, $vignette, 

$vignetteLargeurMax, $vignetteHauteurMax) { 

$imOriginale = Simagecreatef romjpeg ($grandelmage) 

or die ( "impossible de creer un flux d' image GD2 . " ) ; 

$inf oOriginale = getimagesize ( $grandelmage) ; 

} 

makeVignette (" images/ciel2 . jpg" , "vignettes/ciel2 . j pg" , 50, 50); 
?> 
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La fonction getimagesi ze() permet de recuperer des informations sur une image et de les 
stacker dans un tableau. L'indice de ce tableau contient la largeur de l'image, et 
l'indice 1 contient la hauteur de l'image. 

Ces informations vont nous permettre de determiner precisement quelles vont etre les 
dimensions de notre vignette, de maniere a ne pas deformer l'image : 

^0t gd_vignette.php 

<?php 

function makeVignette ( $grandelmage, 

$vignette , 

$vignetteLargeurMax, 
$vignetteHauteurMax) { 

$imOriginale = @imagecreatef romjpeg ( $grandelmage ) 

or die ( "impossible de creer un flux d' image GD2 . " ) ; 

$inf oOriginale = getimagesize ( $grandelmage ) ; 

$largeurVignette ; 
$hauteurVignette ; 

if ($inf oOriginale [0] >= $inf oOriginale [ 1 ]) { 
$largeurVignette = $vignetteLargeurMax; 

$hauteurVignette = ( $vignetteLargeurMax/ $inf oOriginale [ ] ) 
*$infoOriginale[l] ; 

} else { 

$hauteurVignette = $vignetteHauteurMax; 

$largeurVignette = ( $vignetteHauteurMax/ $inf oOriginale [ 1 ] ) 
*$infoOriginale[0] ; 

} 

$im = @imagecreatetruecolor ( $largeurVignette , 

$hauteurVignette) 
or die ( "impossible de creer un flux d' image GD2 . " ) ; 

} 

makeVignette (" images/ciel2 . jpg" , "vignettes/ciel2 . j pg" , 50, 50); 
?> 

La fonction imagecreatetruecol or () permet de creer un objet image qui contient une 
image vide ayant le premier argument ($1 argeurVignette, dans notre exemple) pour 
largeur, et le second argument ($hauteurVignette, dans notre exemple) pour hauteur. 
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II ne nous reste plus qu'a creer la vignette sur le disque : 

J^jt gd_vignette.php 

<?php 

function makeVignette ( $grandelmage, 

$vignette, 

$vignetteLargeurMax, 
$vignetteHauteurMax) { 

$imOriginale = Simagecreatef romjpeg ($grandelmage) 

or die ( "impossible de creer un flux d' image GD2 vignette."); 

$inf oOriginale = getimagesize ( $grandelmage) ; 

$largeurVignette ; 
$hauteurVignette ; 

if ( $inf oOriginale [ ] >= $inf oOriginale [ 1 ]) { 
$largeurVignette = $vignetteLargeurMax; 

$hauteurVignette = ( $vignetteLargeurMax/$inf oOriginale [ ] ) 
*$infoOriginale[l] ; 

} else { 

$hauteurVignette = $vignetteHauteurMax; 

$largeurVignette = ( $vignetteHauteurMax/$inf oOriginale [ 1 ] ) 
*$infoOriginale[0] ; 

} 

$imVignette = @imagecreatetruecolor ( $largeurVignette , 

$hauteurVignette) 

or die ( "impossible de creer un flux d' image GD2 . " ) ; 

if ( ! imagecopyresized ( $imVignette , 

$imOriginale, 
0, 0, 0, 0, 
$largeurVignette, 
$hauteurVignette , 
$inf oOriginale [ ] , 
$inf oOriginale [ 1 ] ) ) { 

return false; 

} 

imagejpeg ($imVignette, $vignette) ; 
return true; 

} 
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if ( ! makeVignette ( "images/ ciel2 . j pg" , 

"vignettes/ ciel2.jpg", 
50, 50)){ 

echo "Erreur : la vignette n' a pas ete creee" ; 
} else { 

echo "la vignette a bien ete creee" ; 

} 

?> 



Notre fonction makeVignette() est a present operationnelle : la fonction 
imagecopyresi zed ()redimensionne l'image contenue par l'objet image $imOriginale et 
la copie dans l'objet image $imVi gnette. Enfin, la fonction i mage j peg ()sauvegarde notre 
vignette sur le disque. 

Voici la definition de la fonction imagecopyresi zed () : 



imagecopyresized() 

Redimensionne l'image src_image et la copie dans l'image dst_image. Vous pouvez 
choisir de ne copier et/ou redimensionner qu'une partie de l'image, et la positionner 
n'importe ou dans l'image de destination. 

Syntaxe bool imagecopyresi zed (resource dst_image, resource 

src_image, int dst_x, int dst_y, int src_x, int src_y, int 
dst_w, int dst_h, int src_w, int src_h) 

dstjm L'image de destination. 

srcjm L'image source. 

dst_x Abscisse du coin superieur gauche de l'image copiee par rapport a 

l'image de destination. 

dst_y Idem, mais avec l'ordonnee. 

src_x Designe, dans l'image source, l'abscisse du point representant le 

coin superieur gauche de l'image a copier : nous ne sommes pas 
forces de copier l'integralite de l'image source. 

src_y Idem, mais avec l'ordonnee. 

dst_w La largeur de notre copie, sur son image de destination. 

dst_h La hauteur de notre copie, sur son image de destination. 

srcj La largeur du morceau d' image que nous souhaitons copier, sur 

l'image source. 
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src_h Idem, mais avec la hauteur. 

Notre fonction makeVignette() est certes operationnelle, mais elle est limitee. Nous ne 
pouvons l'appliquer que sur des images de type JPEG. Afin de passer outre, nous allons 
devoir determiner quel est le type de l'image originale avant de creer l'objet image qui 
s'y rapporte. Puis, nous allons faire en sorte que le type de la vignette soit donne par son 
nom (argument $vignette de la fonction). 

II s'avere que la fonction getimagesize(), que nous utilisons deja dans notre code, 
renvoie aussi le type de l'image dans le tableau, index 2, sous la forme d'un entier. Nous 
allons done utiliser cette possibilite dans notre code : 

<^jt gd_vignette.php 

<?php 

function makeVignette ( $grandelmage, $vignette, $vignetteLargeurMax, 

$vignetteHauteurMax) { 

$inf oOriginale = getimagesize ( $grandelmage) ; 

$imageOriginale; 

switch ( $infoOriginale [2 ] ) { 
case 1 : 

$ imOr iginale = @imagecreatef romgif ( $grandelmage) 

or die ( "impossible de creer un flux d' image GD2 
break; 

case 2 : 

$imOriginale = @imagecreatef romjpeg ($grandelmage) 

or die ( "impossible de creer un flux d' image GD2 
break; 
case 3 : 

$imOriginale = @imagecreatef rompng ( $grandelmage) 

or die ( "impossible de creer un flux d' image GD2 
break; 
case 15 : 

$imOriginale = @imagecreatef romwbmp ($grandelmage) 

or die ( "impossible de creer un flux d' image GD2 
break; 
default : 

return false; 

} 

$largeurVignette ; 
$hauteurVignette ; 
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vignette . " ) ; 



vignette . " ) ; 



vignette . " ) ; 
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if ( $inf oOriginale [ ] >= $inf oOriginale [ 1 ] ) { 
$largeurVignette = $vignetteLargeurMax; 

$hauteurVignette = ( $vignetteLargeurMax/ $inf oOriginale [ ] ) 
*$inf oOriginale [1 ] ; 

} else { 

$hauteurVignette = $vignetteHauteurMax; 

$largeurVignette = ( $vignetteHauteurMax/ $inf oOriginale [ 1 ] ) 
*$inf oOriginale [ ] ; 

} 

$imVignette = @imagecreatetruecolor ($largeurVignette, 
$hauteurVignette ) 

or die (" impossible de creer un flux d' image GD2 . " ) ; 

if ( ! imagecopyresized ( $imVignette, $imOriginale, 0, 0, 0, 0, 

$largeurVignette, $hauteurVignette , 
$inf oOriginale [ ] , $inf oOriginale [1 ] ) ) { 

return false; 

} 

switch (strrchr ( $ vignette, " . " ) ) { 
case " . jpg" : 

image j peg ( $imVignette, $vignette) ; 

break; 
case " . jpeg" : 

image j peg ( $imVignette , $vignette) ; 

break; 
case " . gif " : 

imagegif ( $ imVignette, $vignette) ; 

break; 
case " . png" : 

imagepng ($imVignette, $vignette) ; 

break; 
case " . wbmp" : 

imagewbmp ( $imVignette, $vignette) ; 

break; 
default : 

return false; 

} 

return true; 

} 

if ( ! makeVignette ( "images/ ciel2 . jpg" , 

"vignettes/ ciel2 . jpg" , 
50, 50)){ 
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echo "Erreur : la vignette n'a pas ete creee"; 

} else { 

echo "la vignette a bien ete creee<br />" ; 

echo "<img alt='grosse image' src=' images/ciel2 . j pg' />"; 

echo "<img alt='petite image' src=' vignettes/ciel2 . jpg' />"; 

} 

?> 
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/ T^llfr [l— i http://localhost/dynamisez%20PHP/chap03/gd_vignetl:e.php 



la vignette a bien ete creee 



Fig. 3.2 : 

L'image d'origine et, 
juste a cote, son alter 
ego "vignette" 




Voici les differentes valeurs que peut prendre l'index 2 du tableau renvoye par la fonction 
getimagesize(): 

1 =GIF 

2 =JPEG 

3 = PNG 

4 = SWF 

5 = PSD 

6 = BMP 

7 = TIFF {Intel byte order) 
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8 = TIFF (Motorola byte order) 

9 = JPC 

10 = JP2 

11 = JPX 

12 = JB2 
■ 13 = SWC 

14 = IFF 

15 = WBMP 

16 = XBM 

r 

Ecrire et superposer une image sur une autre 

Vous avez besoin d'incmster un logo sur une image, puis d'y ecrire quelque chose, tout 
cela grace a PHPet GD2 ? Rien de plus simple. Voyons d'abord comment incruster un 
logo (ou quoi que ce soit) sur une image. 

Nous allons pour ce faire creer une nouvelle fonction. Toujours dans le repertoire chap03, 
creez un fichier gd_incrustation.php, ainsi qu'un repertoire incrustations. 

Ouvrez gd_incrustation.php avec votre editeur favori et entrez le code suivant : 
gdjncrustation.php 

<?php 

function incrustelmage ($image, 

$imageFini , 
$logoLargeurMax, 
$logoHauteurMax ) { 

} 

?> 

Cette fonction prend en compte quatre arguments : le premier indiquera l'adresse de 
l'image originale, le deuxieme l'endroit ou nous voulons stacker l'image une fois traitee, 
le quatrieme et le cinquieme indiqueront la taille maximale du logo sur l'image. Comme 
nous considerons qu'il n'y a qu'un seul logo, l'adresse de celui-ci sera code directement 
dans la fonction. 

Commencons par creer les images dont nous aurons besoin : 

$info!mage = getimagesize ( $image) ; 
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$imOriginale = @imagecreatef romj peg ($ image) 

or die ( "impossible de creer un flux d' image GD2"); 

// utilisez 1' image de votre choix : 
$adresseLogo = "images/redf ish . gif " ; 

$imLogo = dimagecreatef romgif ( $adresseLogo) 

or die ( "impossible de creer un flux d' image GD2 . " ) ; 

$infoLogo = getimagesize ($adresseLogo) ; 

Vous remarquerez que nous recuperons des informations sur ces images grace a la 
fonction getimagesi ze() . Cela nous permet, dans un premier temps, de gerer le 
redimensionnement du logo grace au petit algorithme que nous avions vu lorsque nous 
reduisions des images en vignettes. Ajoutons done le code suivant a notre fonction : 

$largeurLogo; 
$ hauteur Logo; 

if ( $inf oLogo [ ] >= $inf oLogo [1 ] ) { 
$largeurLogo = $logoLargeurMax; 

$hauteurLogo = ( $ logoLargeurMax/$ inf oLogo [ ] ) * $inf oLogo [ 1 ] ; 
} else { 

$hauteurLogo = $logoHauteurMax ; 

$largeurLogo = ( $ logoHauteurMax/$inf oLogo [ 1 ] ) * $inf oLogo [ ] ; 

} 

II ne nous reste plus qu'a realiser l'incrustation en elle-meme : 

if ( ! imagecopyresized ($imOriginale, 

$imLogo, 
10, 10, 0, 0, 
$largeurLogo, 
$hauteurLogo , 
$ inf oLogo [ ] , 
$infoLogo[l] ) ) { 

return false; 

} 

imagegif ( $imOriginale, $imageFini) ; 
return true; 

Nous utilisons encore une fois la fonction imagecopyresized(). Vu le nombre 
d' arguments de cette fonction, il est possible d'operer toutes sortes d'agrandissements et 
de copies. 
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Nous souhaitons maintenant ecrire une petite phrase (par exemple l'adresse d'un site 
web) sur notre image, en meme temps que nous y incrustons le logo. Nous allons done 
continuer a ajouter du code dans notre fonction, apres l'instruction pour l'incrustation et 
avant l'instruction d'ecriture sur le disque (fonction imagegi f ()) : 

// la couleur du texte : 

$couleur = imagecolorallocate ( $imOriginale , 

220, 30, 0); 

// la phrase a ecrire : 

$phrase = "Une magnifique petite phrase !"; 

// la position en x de la phrase ecrite : 

// la position en Y de la phrase ecrite : 

$positionX = 10; 

$positionY = $inf olmage [1] -20; 

$tailleDuTexte = 5 ; 

images t ring ( $imOriginale, 

$tailleDuTexte, 

$positionX, 

$positionY, 

$phrase, 

$couleur) ; 

La fonction imagecol oral 1 ocate() nous permet de definir la couleur que nous utiliserons 
pour notre phrase. Les trois derniers arguments de cette fonction representent les trois 
composantes (rouge, vert et bleu) de la couleur. 

Enfin, la fonction imagestri ng () ecrit notre phrase sur notre image. L'argument 
$tai 1 1 eDuTexte doit etre compris entre 1 et 5. 

Voici a present le code complet du fichier gd_incrustation.php : 
gdjncrustation.php 

<?php 

function incrustelmage ($image, 

$imageFini, 
$logoLargeurMax , 
$logoHauteurMax) { 

$infoImage = getimagesize ( $image ) ; 

$imOriginale = Simagecreatef romjpeg ($image) 
or die ( "impossible de creer un flux 
d' image GD2 vignette, jpg"); 
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$adresseLogo = " images /redf ish . gif " ; 



$imLogo = @imagecreatef romgif ( $adresseLogo) 
or die ( "impossible de creer un flux 
d' image GD2 . " ) ; 



$infoLogo = getimagesize ($adresseLogo) ,■ 



$largeurLogo; 
$hauteurLogo; 



if ( $inf oLogo [ ] 
$largeurLogo 
$hauteurLogo 

} else { 

$hauteurLogo 
$largeurLogo 

} 



>= $infoLogo [1] ) { 
= $logoLargeurMax; 
= ($logoLargeurMax/$inf oLogo [0] ) 
*$inf oLogo [1 ] ; 

= $logoHauteurMax; 
= ($logoHauteurMax/$inf oLogo [1] ) 
*$inf oLogo [0 ] ; 



if ( ! imagecopyresized ( $imOriginale, $imLogo, 10, 10, 0, 0, 

$largeurLogo, $hauteurLogo, $inf oLogo [ ] , 
$inf oLogo [1] ) ) { 

return false; 

} 

// la couleur du texte : 

$couleur = imagecolorallocate ( $imOriginale, 220, 30, 0); 
// la phrase a ecrire : 

$phrase = "Une magnifique petite phrase !"; 
// la position en x de la phrase ecrite : 
$positionX = 10; 

// la position en Y de la phrase ecrite : 
$positionY = $inf olmage [ 1 ] -2 ; 
$tailleDuTexte = 5; 

imagestring ( $imOriginale, $tailleDuTexte, $positionX, 
$positionY, $phrase, $couleur) ; 



imagegif ( $imOriginale, $imageFini) ; 



return true; 

} 



if ( ! incrustelmage ( "images/ guitare -jpg", "incrustations/ guitare .gif" 
150, 150) ) { 

echo "Erreur : la vignette n' a pas ete creee"; 
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} else { 

echo "la vignette a bien ete creee</br>" ; 

echo "<img alt=incrustation' src= incrustations/guitare . gif ' />"; 

} 

?> 



Mozilla Firefox 



Fichier Edition Affichage Historique Marque-pages Outils ? 



' T ^ ^ ^ | □ hi=i=p:/ /lQcalhQ5i=/dynarni5ez%20PHP/chap03/gd_incru5i=ai=iQn,php 



la vignette a bien ete creee 




Fig. 3.3 : 

Notre incrustation 



Dessiner sur une image 

GD2 est fourni avec tout ce qu'il faut pour dessiner. Imaginons que vous ayez besoin, par 
exemple, de generer un graphique sous forme d'image. Nous allons done creer pas a pas 
un script PHP qui construira un histogramme representant un nombre indefmi 
d'enregistrements. 

Commencez par creer, dans votre repertoire chap03, un fichier appele graphique _data 
.php : 

fl^jt graphique_data.php 

<?php 

$graphique_data = array ( 

' titre' => "mon super graphique", 
'configuration' => array ( 

'unite' => "cm", 

'maximum' => 100 
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) , 




' enregistrements' => array ( 


array ( 




' nom' — > 


"Un" , 


' valeur ' 

) , 


=> 5 


array ( 




' nom' — > 


"Deux" , 


' valeur' 

) , 


=> 10 


array ( 




' nom' — > 


"Trois " , 


' valeur' 

) , 


=> 2 


array ( 




' nom' => 


"Quatre" , 


' valeur' 

) , 


=> 35 


array ( 




' nom' => 


"Cinq", 


' valeur' 

) , 


=> 55 


array ( 




' nom' => 


"Six", 


' valeur' 

) 


=> 80 


) 

) ; 

?> 





II n'est compose que d'un tableau contenant les donnees du graphique. Nous pourrons 
ajouter ou enlever des enregistrements a notre gre. 

Creez maintenant le fichier graphique. php (toujours dans le repertoire chap03) et 
remplissez-le ainsi : 

graphique. php 

<?php 

header ( "Content-type : image/png") ; 

/ / importe le tableau : 

require once ( ' graphique_data . php' ) ; 

$largeur = 8 00; 
$hauteur = 600; 
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// information sur le repere : 
$repere = array ( 

'origine' => array ( 

' x' => 50, 

' y' => $hauteur-75 

) , 

'maxY' => 5, 

'maxX' => $largeur-20 

) ; 

$repere [ ' longueurAbscisse' ] = $repere [' origine' ] ['y'] 

-$repere [ ' maxY' ] ; 

$repere [ ' longueurOrdonnee' ] = $repere [ ' maxX' ] 

-$ repere [' origine' ] [ ' x' ] ; 

// creer une image a palette : 

$image = imagecreate ($largeur, $hauteur) ; 

// donner un fond a 1' image : 

$blanc = imagecolorallocate ( $image , 255, 255, 255); 
imagefill ($image, 0, 0, $blanc) ; 

// dessiner le repere : 

$grisfonce = imagecolorallocate ($ image , 20, 20, 20); 
imagesetthickness ( $image, 2); 
imageline ( 
$ image, 

$ repere [' origine' ] ['x'], 
$repere [ ' maxY' ] , 
$ repere [' origine' ] ['x'], 
$ repere [' origine' ] ['y'], 
$grisf once 

) ; 

imageline ( 
$ image, 

$ repere [' origine ' ] ['x'], 
$ repere [' origine' ] ['y'], 
$repere [ ' maxX' ] , 
$ repere [' origine' ] ['y'], 
$grisf once 

) ; 

/* 

futur code 

*/ 
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imagepng ($ image ) ; // ecrit l'image 

imagedestroy ($image) ; // detruit la "resource" image 
?> 



Vous pouvez d'ores et deja admirer l'incroyable resultat en lan9ant ce fichier depuis votre 
navigateur prefere. 

Remarquez bien que la premiere chose que nous faisons apres avoir cree notre image avec 
la fonction imagecreate() , c'est de lui assigner une couleur de fond. 

Nous dessinons ensuite les deux axes de notre repere orthonorme. Pour ce faire, nous 
commencons par definir la couleur que nous allons utiliser. Nous utilisons alors la 
fonction imagesetthi cknessQ afin de donner une epaisseur de 2 pixels aux traits que 
nous allons tracer. Les deux lignes sont ensuite tracees grace a imagel ine(). 

Imageline() 

Cette fonction vous permet de tracer une ligne sur une image. 

Syntaxe bool imageline (resource image, intxi, int yi, int x2, int 
y2, int color) 

Image L'image sur laquelle nous allons tracer le trait. 

xl L'abscisse du point de depart de notre ligne. 

yl L'ordonnee du point de depart de notre ligne. 

x2 L'abscisse du point d'arrivee de notre ligne. 

y2 L'ordonnee du point d'arrivee de notre ligne. 

Nous calculons les coordonnees de ces lignes en prenant en compte la hauteur et la 
largeur de notre image. Cela nous permettra d' avoir des graphiques de tailles differentes 
simplement en changeant les variables $largeur et $hauteur. 

Nous allons maintenant faire apparaitre tout ce qui se doit d'etre ecrit sur notre 
histogramme : 

//ecrit le titre du graphique 

$rouge = imagecolorallocate ( $image , 220, 30, ) ; 
imagestring ($image, 
5, 10, 

$hauteur-2 , 

$graphique_data [ ' titre' ] , 
$ rouge) ; 
imagestring ($image, 

5, 55, 0, 
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$graphique_data ['configuration'] ['unite'], 
$grisfonce) ; 
imagestring ( $image, 
5, 40, 

$hauteur-75 , 
"0", 

$grisfonce) ; 

Enfin, nous allons faire apparaitre les barres de notre histogramme : 

//fait apparaitre les barres de 1 ' histogramme 
// calcul de la largeur des barres : 
$largeurBarre = $repere [ ' longueurAbscisse' ] / 
( (count 

( $graphique_data [ ' enregistrements ' ] ) 
*2 

)+l) ; 

$bleu = imagecolorallocate ($image, 0, 20, 230); 
for($i = ; 

$i < count ( $graphique_data [' enregistrements' ] ) ; 
$i++) { 

/ / calcul des coordonnees des deux angles de la barre 
$barre = array ( 

' xl ' => $repere ['origine'] ['x'] + ((($i*2)+l) * $largeurBarre ) , 
'yl' => $repere [' origine '][' y' ]-(( $repere [' longueurOrdonnee' ] 
*$graphique_data [' enregistrements' ] [$i] [ ' valeur ' ] ) /$graphique 
data [ ' configuration' ] [ 'maximum' ] ) , 
'x2' => $repere [' origine' ][' x' ] + (( ($i*2) +2 ) * $largeurBarre ) , 
' y2 ' => $repere [' origine' ] ['y'] 

) ; 

// dessine le rectangle (la barre) 

imagef illedrectangle ( $image, $barre [ ' xl ' ] , $barre [ ' yl ' ] , 

$barre [ ' x2 ' ] , $barre [ ' y2 ' ] , $bleu) ; 

} 

Certaines formules mathematiques utilisees ici peuvent paraitre barbares mais, 
rassurez-vous, la plus compliquee n'est qu'un simple produit en croix. 

Lorsque vous testez ce fichier, votre histogramme apparait correctement dans votre 
image. Vous pouvez deja changer les parametres du fichier graphique_data.php pour vous 
amuser et, par la meme occasion, apprecier la puissance de GD2. 

Nous allons maintenant modifier cette derniere portion de code arm d'integrer sur notre 
image les dernieres informations qui nous manquent. A savoir : le nom de chacun des 
enregistrements, ainsi que - dans un souci de precision - sa valeur. 
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Voici l'ensemble du code du fichier graphique.php contenant les dernieres modifications. 
A vous de les trouver ! 

graphique.php 

<?php 

header ( "Content-type : image/png") ; 

require once ( ' graphique_data . php' ) ; // importe le tableau 

$largeur = 800; 
$hauteur = 600; 

// information sur le repere 
$repere = array ( 

'origine' => array ( 

'x' => 50, 

' y' => $hauteur-75 

) , 

'maxY' => 5, 

'maxX' => $largeur-20 

) ; 

$repere [ ' longueurOrdonnee' ] = $repere [' origine' ] ['y'] 

-$repere [ ' maxY' ] ; 
$repere [ ' longueurAbscisse' ] = $repere [ ' maxX' ] 

-$repere [ ' origine' ] [ ' x' ] ; 

/ / creer une image a palette 

$image = imagecreate ( $largeur , $hauteur) ; 

// donner un fond a 1' image 

$blanc = imagecolorallocate ( $image, 255, 255, 255); 
imagef ill ( $image , 0, 0, $blanc) ; 

// dessiner le repere 

$grisfonce = imagecolorallocate ( $image, 20, 20, 20); 
imagesetthickness ( $image, 2); 

imageline ($image, $repere [' origine' ][' x' ] , $repere [ ' maxY' ] , 
$ repere ['origine' ] ['x' ] , $ repere ['origine'] ['y'], 
$grisfonce) ; 

imageline ( $ image, $repere['origine' ] ['x' ] , $ repere [' origine' ] [ ' y' ] , 
$repere [ ' maxX' ] , $repere [' origine' ][' y' ] , $grisfonce) ; 

//ecrit le titre du graphique 

$rouge = imagecolorallocate ( $image , 220, 30, 0); 
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imagestring ( $image, 5, 10, $hauteur-20, $graphique_data [ ' titre' ] , 
$rouge ) ; 

imagestring ( $image , 5, $repere [ ' origine' ] [ ' x' ] +5 , 

, $graphique_data [ ' configuration' ] [ ' unite' ] , 
$grisfonce) ; 

imagestring ( $image , 5, 40, $repere [' origine' ] ['y'], 
"0", $grisfonce) ; 

//fait apparaitre les barres de 1 ' histogramme 
// calcul de la largeur des barres : 
$largeurBarre = $repere [ ' longueurAbscisse' ] / 

( (count ( $graphique_data [ ' enregistrements' ] ) 

*2)+l) ; 

$bleu = imagecolorallocate ($image, 0, 20, 230); 
for($i = ; 

$i<count ( $graphique_data [ ' enregistrements' ] ) ; 

$i++) { 

/ / calcul des coordonnees des deux angles de la barre 
$barre = array ( 

' xl ' => $repere ['origine'] ['x'] + ((($i*2)+l) * $largeurBarre ) , 

'yl' => $repere [' origine' ] ['y'] 

- ( ($repere [ ' longueurOrdonnee' ] 

*$graphique_data [' enregistrements' ] [$i] ['valeur']) 
/$graphique data [' configuration' ] ['maximum']), 

' x2 ' => $repere ['origine'] ['x'] + ((($i*2)+2) * $ largeur Bar re ) , 

' y2 ' => $repere [' origine' ] ['y']-2 

) ; 

// dessine le rectangle (la barre) 

imagef illedrectangle ( $image, $barre [ ' xl ' ] , $barre [ ' yl ' ] , 

$barre [ ' x2 ' ] , $barre [ ' y2 ' ] , $bleu) ; 
// Ecrit le nom de 1' enregistrement 

imagestringup ( $image, 5, $barre [ ' xl ' ] , $barre [ ' y2 ' ] -2 , 

$graphique_data [' enregistrements' ] [$i] ['nom' ] , 
$blanc) ; 

// Ecrit la valeur de 1' enregistrement 

imagestring ( $image, 5, $barre [ ' xl ' ] , $barre [ ' yl' ] -15, 

$graphique_data [' enregistrements' ] [$i] ['valeur'], 

$grisfonce) ; 

} 

imagepng ( $image) ; // ecrit l'image 

imagedestroy ($image) ; // detruit la "resource" image 
?> 
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Fig. 3.4 : Et voila le graphique 

3.3 Utiliser ImageMagick et MagickWand 

Meme si GD2 est relativement simple d' installation et d'utilisation, il reste souvent bien 
limite. Quid des effets d'images traditionnels, comme le flou ? Quid des polices de 
caracteres et de leur orientation ? L'ensemble ImageMagick et MagickWand repond bien 
a cette problematique, et parfois meme, plus rapidement que GD2. En contrepartie, 
1' installation de cette extension est assez particuliere, autant dire qu'elle est rarement 
presente sur les serveurs mutualises. 



Installation 

ImageMagick est un programme de retouche d'images qu'il est necessaire d'installer sur 
votre machine arm de pouvoir utiliser ses puissantes fonctionnalites. Pour le telecharger, 
rendez-vous a l'adresse http://www.imagemagick.org/, et choisissez la version 8 ou 16 bits 
suivant la puissance de votre ordinateur. Double-cliquez ensuite sur le fichier executable 
obtenu, et suivez la procedure d'installation. 

Une fois 1' installation terminee, ouvrez une fenetre de commande (choisissez Invite de 
commandes dans le menu Demarrer/Programnies/Accessoires). Depuis Plnvite de 
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commandes, deplacez-vous dans un dossier contenant des images, puis entrez la 
commande (en remplacant logo.gif par le nom d'une de vos images): Imdi splay 
logo.gif. 

L'interface de ImageMagick s'ouvre sur cette image. Le programme est correctement 
installe, vous pouvez fermer ImageMagick. 

MagickWand est ce que Ton appelle un wrapper. II permet d'utiliser directement les 
fonctions de ImageMagick en les appelant avec des fonctions PHP. 

Comme l'immense majorite des extensions PHP, MagickWand se trouve sous forme de 
fichiers .dll. Pour les recuperer, allez a l'adresse http://www.magickwand.org/download/php/ 
windows/ et telechargez les fichiers php_magickwand_dyn.dll et php_magickwand 
_ql6_st.dll, ainsi que la documentation. 

Copiez vos fichiers .dll dans le repertoire des extensions de PHP, puis editez votre fichier 
php.ini afin de declarer ces nouvelles extensions. Relancez Apache. Le tour est joue. 

Nous allons maintenant ecrire le fichier magickwandtest.php, que nous placons dans notre 
repertoire chap03. Ce fichier a pour but d' ecrire une phrase sur une image et nous 
permettra de verifier le bon fonctionnement de 1' installation. 

Voici le code de magickwandtest.php : 
magickwandtest.php 

<?php 

header ( "Content-type : image/ jpeg" ) ; 
// creer un objet MagickWand 
$magick_wand=NewMagickWand ( ) ; 

/ / ouvre une image 

MagickReadlmage ( $magick wand, ' images/ guitare . jpg' ) ; 

// creer un objet DrawingWand 

$drawing_wand=NewDrawingWand ( ) ; 

// Choix d'une police de caracteres/ 

DrawS et Font ( $drawing_wand, " impact . tt f " ) ; 

// Reglage de la taille du texte/ 

DrawSetFontSize ( $drawing_wand, 20 ) ; 

// outil de centrage/ 

DrawSetGravity ( $drawing_wand, MW CenterGravity ) ; 

//creer un objet PixelWand 
$pixel_wand=NewPixelWand ( ) ; 

PixelSetColor ( $pixel wand, "white" ) ; // choix de la couleur 
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// choisit la couleur a utiliser pour remplir les objets, a partir de 

la couleur d'un objet PixelWand. 
DrawSetFillColor ( $drawing wand, $pixel wand) ; 

// Ecrit sur 1' image 

if (MagickAnnotatelmage ( $magick wand, $drawing wand, 0, 0, 0, 

"salut le monde ! ! ! ") != 0) { 
MagickEchoImageBlob ( $magick wand ) ; 
} else { 

echo MagickGetExceptionString ( $magick wand) ; 

} 

?> 

Avant de lancer ce fichier depuis votre navigateur favori, assurez-vous de cibler une 
image existante et un fichier de police de caracteres egalement existant (vous pouvez 
copier un fichier de police de caracteres dans le meme repertoire que celui de votre fichier 
magickwandtest.php) . 

MaTtriser des effets pour les images 

Explorer entierement MagickWand demanderait un ouvrage complet sur le sujet : c'est 
pourquoi nous n'allons voir qu'une toute petite partie de ce programme, mais qui reste 
impressionnante, puisque nous allons traiter des filtres. 




Fig. 3.5 : L'image que nous utilisons pour illustrer cette section 
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Appliquer des effets 

Nous allons commencer par simplement flouter une image. Pour cela, creez dans votre 
repertoire chap03 un fichier intitule magicLphp : 

<^ magick.php 

<?php 

header ( "Content-type : image/ jpeg" ) ; 

// creer un objet MagickWand 
$magick wand=NewMagickWand ( ) ; 

/ / ouvre une image 

MagickReadlmage ( $magick wand, ' images/ guitare . jpg' ) ; 
// Ecrit sur 1' image 

if (! MagickBlur Image ( $magick wand, 20, 5)) { 
echo MagickGetExceptionString ( $magick wand) ; 

} 

MagickEchoImageBlob ( $magick wand ) ; 
?> 

Si vous ouvrez magicLphp depuis votre navigateur, vous trouverez votre image 
completement floue. Regardons le code d'un peu plus pres. 

La premiere ligne que nous ecrivons concerne la fonction header()qui, apres avoir vu le 
fonctionnement de GD2, doit vous sembler evidente. 

Tout de suite apres, nous creons un objet MagickWand, grace a la fonction 
NewMagickWandQ. Cet objet est celui qui chargera l'image que nous souhaitons modifier, 
et c'est par lui que s'y appliqueront toutes les modifications. 

La fonction Magi ckRead Image () nous permet de preciser l'adresse de l'image que nous 
souhaitons arranger a notre facon. Comme nous chargeons une image de type JPEG, 
MagickWand creera en sortie une image de type JPEG ; ce qui explique le content-type 
de la fonction header (). 

Maintenant que notre image est en memoire, nous allons la flouter grace a la fonction 
MagickBlurImage(). 
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MagickBlurlmage() 

Cette fonction permet d'appliquer un effet flou a une image. 




Syntaxe bool Magi ckBl urImage(Magi ckWand mgck_wnd, float radius, 

float sigma [, int channel_type]) 

mgck_wnd L'objet MagickWand, reference de l'image sur laquelle nous 

souhaitons appliquer l'effet. 

Radius Le rayon de notre effet flou. 



Sigma Le parametre sigma de notre effet flou. 



channel_type Doit correspondre a l'une des constantes correspondant a un canal 

couleur, permettant de n' appliquer l'effet que sur le canal rouge, 
par exemple. 



Le dernier argument de cette fonction permet de specifier un canal couleur particulier sur 
lequel s'appliquera la transformation. II doit prendre pour valeur la constante 
correspondant au canal couleur souhaite. 

Modifiez votre code de la maniere suivante : 

if (! MagickBlur Image ( $magick wand, 20, 5, MW MagentaChannel) ) { 
echo MagickGetExceptionStr ing ( $magick wand) ; 

} 

Maintenant, seul le canal magenta de votre image est floute, lui donnant ainsi une touche 
tres... fluo. 

Voici les differentes constantes utilisables dans ce contexte : 

MW_RedChannel 

MW_GreenChannel 

MW_BlueChannel 

MW_CyanChannel 

MW_MagentaChannel 

MW_YellowChannel 

MW_BlackChannel 

MW_AlphaChannel 

MW_OpacityChannel 
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MW_IndexChannel 
MW_A11 Channels 

Magic kWand propose d' autre types de flous, via des fonctions tres semblables a 
MagickBlurImage(). Les voici : 

bool Magi ckGaussi anBl urlmage( MagickWand mgck_wnd, float radius, float 
sigma [, int channel_type] ) 

bool MagickMotionBlurImage( MagickWand mgck_wnd, float radius, float sigma, 
float angle ) 

bool MagickRadialBlurImage( MagickWand mgck_wnd, float angle ) 

Bien stir, il existe dans MagickWand un certain nombre d'effets. En voici quelques-uns : 

bool MagickOil Pai ntlmage( MagickWand mgck_wnd, float radius ): effet 
"peinture a l'huile" ; 

bool Magi ckRai selmage( MagickWand mgck_wnd, float width, float height, int 
x, int y, bool raise ) : ajoute un petit effet 3D a l'image, lui donnant l'apparence 
graphique d'un bouton standard ; 

bool Magi ckSwi rl Image ( MagickWand mgck_wnd, float degrees ) : effet tourbillon ; 
i bool MagickNegateImage( MagickWand mgck_wnd [, bool only_the_gray [, int 
channel _type]] ) : donne le negatif de l'image ; 
Etc. 

Vous voulez superposer plusieurs nitres ? Voici la marche a suivre : 

/ / ouvre une image 

MagickReadlmage ( $magick wand, ' images/ guitare . jpg' ) ; 
// Joue sur le negatif 

if ( ! MagickNegatelmage ( $magick wand, false, MW YellowChannel) ) { 
echo MagickGetExceptionString ( $magick wand) ; 

} 

// Effet tourbillon 

if ( ! MagickSwirllmage ( $magick wand, -180)) { 
echo MagickGetExceptionString ( $magick wand) ; 

} 

MagickEchoImageBlob ( $magick wand ) ; 
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Fig. 3.6 : Voici a quoi ressemble notre guitare apres un tel traitement 

Superposer des images 

Nous allons maintenant superposer une seconde image par-dessus la premiere. 




Fig. 3.7 : Voici I'image que nous allons utiliser pour la superposition 
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magick.php 

<?php 

header ( "Content-type : image/ j peg" ) ; 

// creer un objet MagickWand 
$magick wand=NewMagickWand ( ) ; 

// creer un objet MagickWand 
$magick wand2=NewMagickWand ( ) ; 

/ / ouvre une image 

MagickReadlmage ( $magick wand, ' images/ guitare . jpg' ) ; 
/ / ouvre une seconde image 

MagickReadlmage ( $magick wand2 , ' images/ redf ish . gif ' ) ; 
// Joue sur le negatif 

if ( ! MagickNegatelmage ( $magick_wand, false, MW_YellowChannel ) ) { 
echo MagickGetExceptionString ( $magick wand) ; 

} 

// Effet tourbillon 

if ( ! MagickSwirllmage ( $magick_wand, -180)) { 
echo MagickGetExceptionString ( $magick wand) ; 

} 

// superposer 1' image 

if ( ! MagickAddlmage ( $magick wand, $magick_wand2 ) ) { 
echo MagickGetExceptionString ( $magick wand) ; 

} 

MagickEchoImageBlob ( MagickFlattenlmages ( $magick wand) ); 
?> 

II est necessaire de creer un second objet Magi ckWand, arm de charger une seconde image. 
Des nitres peuvent etre appliques separement sur chacune des images. La superposition 
des deux images se fait en deux temps. D'abord, nous les associons grace a la fonction 
Magi ckAddImage() . Ce faisant, les deux images se fondent en une, mais sous forme de 
caiques distincts. Chaque objet MagickWand peut encore subir des transformations 
independamment de l'autre. C'est la fonction Magi ckFl at ten Image () qui va reellement 
superposer les deux images en une seule. 
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Fig. 3.8 : Le resultatde la superposition 



Si vous utilisez la fonction Magi ckFl atten Image ()avant d'appliquer vos filtres (ou tout 
autre transformation), ils s'appliqueront sur les deux images : 

// superposer 1' image 

if ( ! MagickAddlmage ( $magick_wand, $magick_wand2 ) ) { 
echo MagickGetExceptionStr ing ( $magick_wand) ; 

} 

$magick wand = MagickFlattenlmages ( $magick wand) ; 
// Joue sur le negatif 

if ( ! MagickNegatelmage ( $magick wand, false, MW YellowChannel) ) { 
echo MagickGetExceptionString ( $magick wand) ; 

} 

// Effet tourbillon 

if ( ! MagickSwirllmage ( $magick wand, -180)) { 
echo MagickGetExceptionStr ing ( $magick wand) ; 

} 
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Fig. 3.9 : Les filtres ont ete appliques sur les deux images. 

Compresser et enregistrer une image 

A ce stade, il ne nous reste plus qu'a enregistrer l'image sur le disque. Pour ce faire, 
modifiez votre code de la facon suivante : 

// Effet tourbillon 

if ( ! MagickSwirllmage ( $magick_wand, -180)) { 
echo MagickGetExceptionString ( $magick wand) ; 

} 

MagickWritelmage ( $magick wand, "images/magick. jpg" ) ; 
MagickEchoImageBlob ( $magick wand ) ; 

La fonction MagickWriteImage() va creer le fichier magick.jpg a l'adresse passee en 
argument. Par contre, 1'image qui a ete enregistree pese assez lourd. 
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magick.jpg 
691 x511 
Image JPEG 



Dimensions : 691 x 511 
Type : Image JPEG 
Taille : 215 Ko 



Fig. 3.10: 

Le fichier cree pese assez lourd 



Nous allons done rajouter une ligne de code pour profiter de la compression JPEG, juste 
avant la fonction Magi ckWri telmage() (car cela ne sert a rien de compresser alors que 
Ton a deja enregistre 1'image) : 

MagickSetlmageCompressionQuality ( $magick wand, 50); 

Le second argument de cette fonction represente le taux de compression. A 100, la qualite 
de votre image sera optimale. A 1, votre image sera d'une qualite deplorable (a moins 
qu'il ne s'agisse d'un parti-pris artistique), mais elle ne pesera plus bien lourd. 



magick.jpg 
691 x511 
Image JPEG 



Dimensions : 691 x 511 
Type : Image JPEG 
Taille : 23, 1 Ko 



► Fig. 3.11 : 

Avec un taux de compression de 50, notre 
image s'est grandement allegee 



Voici, pour terminer, le code complet de magickphp : 

J^jt magick.php 

<?php 

header ( "Content-type : image/ jpeg" ) ; 

// creer un objet MagickWand 
$magick wand=NewMagickWand ( ) ; 

// creer un objet MagickWand 
$magick wand2=NewMagickWand ( ) ; 

/ / ouvre une image 

MagickReadlmage ( $magick_wand, ' images/ guitare . jpg' ) ; 
/ / ouvre une seconde image 

MagickReadlmage ( $magick_wand2 , ' images/ redf ish . gif ' ) ; 



// superposer 1'image 
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if ( ! MagickAddlmage ( $magick_wand, $magick wand2)) { 
echo MagickGetExceptionString ( $magick wand) ; 

} 

$magick wand = MagickFlattenlmages ( $magick wand) ; 
// Joue sur le negatif 

if ( IMagickNegatelmage ($magick_wand, false, MW_YellowChannel) ) { 
echo MagickGetExceptionString ( $magick_wand) ; 

} 

// Effet tourbillon 

if ( ! MagickSwir llmage ( $magick_wand, -180)) { 
echo MagickGetExceptionString ( $magick_wand) ; 

} 

MagickSetlmageCompressionQuality ( $magick wand, 50); 
MagickWritelmage ( $magick wand, "images/magick. jpg" ) ; 

MagickEchoImageBlob ( $magick wand ) ; 
?> 



L'objet DrawingWand 

En plus de pouvoir appliquer de puissants effets a nos images, MagickWand nous offre 
aussi de nombreux outils de dessins. Nous allons nous familiariser avec un premier 
exemple de l'utilisation de l'objet Drawi ngWand. 

Dans chap03, creez le fichier magick_draw.php, et ajoutez le code suivant : 

header ( "Content-type : image/ jpeg" ) ; 

// creer un objet MagickWand 
$magick wand = NewMagickWand ( ) ; 

/ / ouvre une image 

MagickReadlmage ( $magick wand, "images/guitare . j pg" ) ; 

//creer un objet PixelWand 
$pixel_wand=NewPixelWand ( ) ; 

// creer un objet DrawingWand 
$drawing wand = NewDrawingWand ( ) ; 

Nous creons toujours un objet MagickWand, et ouvrons toujours une image de la meme 
maniere que precedemment. Nous creons aussi deux nouveaux objets : un PixelWand et 
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un Drawi ngWand. Vous pouvez imaginer le Drawn ngWand comme etant un pinceau, un outil 
de dessin que nous pourrons decrire arm d'en faire varier la forme, et le Pixel Wand 
comme etant la peinture que nous allons utiliser avec le pinceau. 

Completez le code comme suit : 

// dessiner 10 cercles dont la taille, 1' emplacement, la couleur 
// et la transparence seront determines par le hasard : 

$couleur = Array ( 

"white", 

"blue", 

"red" , 

"green" , 

"yellow") ; 
for ($i = ; $i < 10 ; $i++) { 

// choix de la couleur : 

PixelSetColor( $pixel_wand, $couleur[rand(0, 4 ) ] ) ; 

// on lie la couleur (l'objet $pixel_wand) 
// au dessin (l'objet $drawing_wand) : 
DrawSetFillColor ( $drawing_wand, $pixel wand) ; 

// on determine la transparence (alpha) de la couleur 
// de remplissage : 

DrawSetFillAlpha ($drawing_wand, rand(0, 33)/100); 

// on determine les coordonnees du cercle : 

$ox = rand(10, MagickGetlmageWidth ( $magick wand) -10); 

$oy = rand(10, MagickGetlmageHeight ( $magick wand)-10); 

$px = rand($ox, MagickGetlmageWidth ( $magick wand) -10); 

$py = rand($oy, MagickGetlmageHeight ( $magick wand) -10); 

// on rajoute notre cercle dans la liste 

// "dessins a faire" de l'objet $drawing wand : 

DrawCircle ( $drawing_wand, $ox, $oy, $px, $py) ; 

} 

// on dessine sur 1' image la totalite des dessins 
// contenus dans la liste des "dessins a faire" 
// de l'objet $drawing wand : 

MagickDrawImage ( $magick wand, $drawing wand) ; 

Ce petit bout de programme va dessiner dix cercles de couleur, de taille et d'opacite 
variables par-dessus notre image. L'ordre des instructions est important. 
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A peine la boucle for commencee, nous appliquons une couleur a $pi xel_wand, via la 
fonction PixelSetColorQ. Dans notre exemple, la valeur de la couleur est choisie au 
hasard dans un tableau. Cette fonction accepte les noms de couleur standard sous forme 
de chaines de caracteres (comme dans notre exemple), ou les couleurs sous leur forme 
hexadecimale (exemple : #FFFFFF). 

Nous lions ensuite $pixel_wand et $drawi ng_wand avec la fonction DrawSetFil lColor() : 
c'est un peu comme tremper notre pinceau dans un seau de peinture. 

La fonction DrawSetFi 1 1 Al pha() permet de donner de la "transparence" a notre pinceau. 
Le second parametre de cette fonction est de type f 1 oat et est contenu entre 
(completement transparent) et 1 (completement opaque). 

Une fois que nous avons determine la couleur et l'opacite de notre pinceau et de notre 
peinture, nous allons nous occuper de tracer un cercle. Pour cela, nous utilisons 
simplement la fonction DrawCircle(). Celle-ci a besoin de savoir quel pinceau va la 
dessiner (c'est le premier argument de cette fonction), mais elle demande aussi quatre 
autres arguments de type float. II s'agit des coins superieur gauche et inferieur droit du 
rectangle dans lequel notre cercle s'inscrira. 

A cette etape, notre cercle n'est pas encore dessine sur l'image. La fonction 
DrawCircleQ n'a fait qu'ajouter notre cercle dans une liste des "trues a dessiner". Ainsi, 
notre boucle for va repeter dix fois cette suite d' instructions et inscrire dix fois dans la 
liste des "trues a dessiner" qu'il faut dessiner un cercle aux proprietes aleatoires. 

Vient enfm la fonction qui va dessiner le contenu de la liste de l'objet DrawingWand : 
MagickDrawImageQ. 

Nous terminons alors notre script ainsi : 

// Joue sur le negatif 

if ( ! MagickNegatelmage ( $magick wand, false, MW YellowChannel) ) { 
echo MagickGetExceptionString ( $magick wand) ; 

} 

// Effet tourbillon 

if ( ! MagickSwirllmage ( $magick wand, -180)) { 
echo MagickGetExceptionString ( $magick wand) ; 

} 

MagickSetlmageCompressionQuality ( $magick wand, 85); 
MagickWritelmage ( $magick_wand, " images /magick . j pg" ) ; 

MagickEchoImageBlob ( $magick wand ) ; 
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De cette maniere, les effets "tourbillon" et "negatif" s'appliquent aussi sur les cercles que 
nous venons de dessiner. 




Fig. 3.1 2 : Un des nombreux resultats possibles 
Voici le code complet du fichier magick_draw.php : 

magick_draw.php 

<?php 

header ( "Content-type : image/ jpeg" ) ; 

// creer un objet MagickWand 
$magick wand = NewMagickWand ( ) ; 

/ / ouvre une image 

MagickReadlmage ( $magick_wand, " images/ guitare . jpg" ) 

//creer un objet PixelWand 
$pixel_wand=NewPixelWand ( ) ; 

// creer un objet DrawingWand 
$drawing wand = NewDrawingWand ( ) ; 
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// dessiner 10 cercles dont la taille, 1' emplacement, la couleur 
// et la transparence seront determines par le hasard : 

$couleur = Array ( 

"white" , 

"blue", 

"red", 

"green" , 

"yellow") ; 
for ($i = ; $i < 10 ; $i++) { 

/ / choix de la couleur : 

PixelSetColor( $pixel_wand, $couleur[rand(0, 4 ) ] ) ; 

// on lie la couleur (l'objet $pixel_wand) 
// au dessin (l'objet $drawing_wand) : 
DrawSetFillColor ( $drawing_wand, $pixel_wand) ; 

// on determine la transparence (alpha) de la couleur 
// de remplissage : 

DrawSetFillAlpha ($drawing_wand, rand(0, 33)/100); 

// on determine les coordonnees du cercle : 

$ox = rand(10, MagickGetlmageWidth ( $magick wand) -10); 

$oy = rand(10, MagickGetlmageHeight ( $magick wand) -10); 

$px = rand($ox, MagickGetlmageWidth ( $magick wand)-10); 

$py = rand($oy, MagickGetlmageHeight ( $magick wand) -10); 

// on rajoute notre cercle dans la liste 

// "dessins a faire" de l'objet $drawing wand : 

DrawCircle ( $drawing_wand, $ox, $oy, $px, $py) ; 

} 

// on dessine sur 1' image la totalite des dessins 
// contenus dans la liste des "dessins a faire" 
// de l'objet $drawing wand : 

MagickDrawImage ( $magick_wand, $drawing wand) ; 
// Joue sur le negatif 

if ( ! MagickNegatelmage ( $magick_wand, false, MW_YellowChannel) ) { 
echo MagickGetExceptionString ( $magick_wand) ; 

} 
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// Effet tourbillon 

if ( ! MagickSwirllmage ( $magick wand, -180)) { 
echo MagickGetExceptionStr ing ( $magick wand) ; 

} 

MagickSetlmageCompressionQuality ( $magick_wand, 85) ; 
MagickWritelmage ( $magick wand, "images/magick. jpg" ) ; 

MagickEchoImageBlob ( $magick wand ) ; 
?> 

Creer des avatars 

Imaginons que nous souhaitons, alors que nous developpons une application 
communautaire, creer un systeme d' avatars. Dans le cadre d'un forum, ce peut etre "la 
petite image que j'ai choisie et qui est apposee a cote de chacun de mes messages". Ann 
que chaque utilisateur dispose d'un avatar tres personnalise mais s'integrant tout de meme 
a une charte graphique, nous nous proposons de creer un petit script qui superpose 
differentes parties de visages les unes sur les autres. 



Nous allons a cet effet creer deux fichiers. L'un, avatar _fonctions.php, contiendra un 
ensemble de fonctions qui manipuleront des objets Drawn ngWand. L'autre, avatar.php, 
assemblera ces Drawi ngWand au sein d'une image. 

Le principe general de notre script 

Voyons, pour commencer, le fichier avatar.php : 

<^ avatar.php 

<?php 

header ( "Content-type : image/ jpeg" ) ; 




Fig. 3.13 : 

Un exemple d' avatar tel que notre code nous 
permettra de le construire. 
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include 'avatar f onctions . php' ; 




// tableau des parametres de 1' avatar 
$avatar = Array ( 

' couleur peau' — > "#d4c7a3", 

' couleur_contour' => "#000000", 

' opacite contour' => 0.5, 

'epaisseur contour' — > 3, 

) ; 




// creer un objet MagickWand 
$magick wand = NewMagickWand ( ) ; 




/ / ouvre le fond blanc 

MagickReadlmage ( $magick wand, " images/blanc 


gif") ; 


/ / Redimens ionnement de notre image en 180* 
MagickScalelmage ( $magick wand, 180, 240); 


240 


// utilisation des fonctions contenues dans 

// le fichier avatar fonctions . php : 

/* 

* 

V 




// un petit effet flou, pour le plaisir : 
MagickGaussianBlur Image ( $magick wand, 2, 1, 


MW RedChannel) ; 


MagickEchoImageBlob ( $magick wand ) ; 
?> 





II y a, dans ce fichier, le tableau $avatar, qui decrit notre avatar. II nous permettra de 
changer a loisir les parametres de notre image. 

Ici, la fonction MagickReadImage() ouvre un fichier nomme blanc.gif. II s'agit d'une 
petite image de 5*5 pixels, toute blanche. C'est elle qui servira de fond au visage que 
nous allons dessiner. La fonction Magi ckScal elmageQ sert a redimensionner notre image 
a la faille que nous souhaitons. 

Le reste du code est, somme toute, classique. 

Le second fichier, avatar _fonctions.php, va contenir des fonctions manipulant des objets 
Drawn ngWand. Voici la premiere fonction que nous y ecrirons, et qui aura pour but de 
dessiner un cercle (representant la tete de notre avatar) : 
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<?php 

function dessineTete ($conf ) { 

// creer un objet DrawingWand 
$drawing wand = NewDrawingWand ( ) ; 

//creer des PixelWand 

$pxl peau = NewPixelWand () ; 

$pxl contour = NewPixelWand () ; 

PixelSetColor( $pxl_peau , $conf [ ' couleur_peau' ] ) ; 
PixelSetColor ( $pxl contour, $conf [ ' couleur contour']); 

DrawSetStrokeWidth ( $drawing wand, $conf [ ' epaisseur contour']); 
DrawSetStrokeAlpha ( $drawing wand, $conf [ ' opacite contour']); 

DrawSetFillColor ($drawing wand, $pxl peau); 
DrawSetStrokeColor ( $drawing wand, $pxl contour); 

DrawCircle ( $drawing_wand, 



return $drawing_wand; 

} 

?> 

Notre fonction, dessi neTete() , prend un argument en parametre : $conf. II s'agit en fait 
du tableau $avatar decrit dans le fichier avatar.php, que nous lui passerons en parametre 
lors de son appel. Ce tableau est utilise pour recuperer des parametres concernant la tete : 
la couleur de la peau, 1' epaisseur du contour, etc. 

A propos de l'epaisseur du contour, il nous semble pertinent de signaler que chaque objet 
que nous allons dessiner dispose d'un fond et d'un contour, que vous pouvez faire 
apparaitre ou non en y attachant une couleur. Ainsi, dans notre exemple, nous nous 
assurons d'avoir un fond colore en appelant la fonction DrawSetFi 1 1 Col or() ; et un 
contour visible en appelant la fonction DrawSetStrokeCol or () . 

Nous utilisons aussi la fonction DrawSetStrokeAl pha() : il s'agit de modifier la 
transparence de notre contour {stroke, en anglais). II existe une fonction similaire, 
DrawSetFi 1 1 Al pha(), qui permet de modifier la transparence de votre couleur de fond, de 
remplissage (fill, en anglais). En fait, beaucoup de fonctions dont le nom est compose 
avec le mot "stroke" ont une soeur jumelle, composee avec le mot "fill", et vice versa. 



90, 150, 
90, 205); 



/ / centre 
/ / rayon 
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Une fois que nous avons configure nos "peintures" (les PiwelWand) et notre "pinceau" (le 
DrawingWand), nous pouvons dessiner le cercle grace a la fonction DrawCircleQ. 



DrawCircle ( $drawingwand 

90, 150, // point 1 
90, 205) ; // point 2 




2 (rayon) 



Fig. 3.14 : 

La fonction DrawCirclel! 



Le premier parametre de cette fonction est, vous l'aurez devine, notre objet DrawingWand. 
Les quatre parametres suivants decrivent deux points se situant dans le systeme de 
coordonnees de notre image (ou l'origine se trouve dans le coin superieur gauche). Le 
premier point (dans notre exemple : x = 90 et y = 150) represente le centre de notre 
cercle. Le second (dans notre exemple : x = 90 et y = 205) represente un point sur le 
cercle, c'est-a-dire que la droite formee par nos deux points est en fait le rayon du cercle 
que nous voulons tracer. 

Pour fmir, notre fonction dessi neTete() renvoie notre objet DrawingWand. Nous pouvons 
maintenant l'utiliser dans notre fichier avatar.php. Modifiez done son code comme suit : 

// utilisation des fonctions contenues dans 
// le fichier avatar fonctions . php : 

MagickDrawImage ( $magick_wand, dessineTete ( $avatar ) ) ; 

/* 
* 

*/ 

Si vous lancez maintenant avatar.php, vous pourrez admirer un incroyable rond au bas de 
votre image. 
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Nous allons done continuer a creer des fonctions qui se chargeront de dessiner les yeux, 
le nez, la bouche, les oreilles (ou plutot, "l'oreille") et les cheveux. Mais avant cela, 
savez-vous ce qu'est une courbe de Bezier ? 

Les courbes de Bezier 

Les courbes de Bezier, comme leur nom l'indique, sont... des courbes. Comme vous vous 
en doutez, nous allons avoir besoin de tracer des courbes pour dessiner nos avatars, et les 
courbes de Bezier sont un outil ideal, mais surement un peu complique a la premiere 
approche. Rien de mieux qu'un bon dessin pour comprendre : 




Une courbe de Bezier 



Comme vous le voyez sur cette image, la courbe de notre exemple se compose de sept 
points. Neanmoins, ils ne suivent pas tous la courbe. En effet, seuls trois points 
(symbolises par des croix) se trouvent sur la courbe. Les points symbolises par des carres 
sont "relies" aux points en forme de croix. Ils indiquent la "direction" que doit prendre 
la courbe. Observez le cheminement de notre courbe entre le point 1 et le point 4 : la 
courbe part du point en direction du point 2, puis change de trajectoire pour aller vers le 
point 3 avant de passer sur le point 4. Bien sur, plus le point de direction est loin de son 
point de passage, plus son impact sur la courbe sera grand. Terminons cette breve 
explication par une regie importante : il y a toujours deux points de direction entre deux 
points de passage. 

Pour tracer une courbe de Bezier avec MagickWand, nous allons, vous vous en doutez, 
avoir besoin des coordonnees de chacun de ces points. Voici comment nous coderions la 
courbe de notre exemple : 



DrawBezier ( $ob j et drawing wand, array ( 




20, 140, 


/ / point 1 




30, 60, 


/ / point 2 




70, 70, 


/ / point 3 




100, 40, 


// point 4 
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130, 


10, 


// 


point 


5 


210, 


60, 


// 


point 


6 


180, 


160) ) ; 


// 


point 


7 



/!\ La fonction DrawBezier ne prend que 2 arguments. 

La liste de nos points doit etre passee en parametre a cette fonction sous la forme d'un tableau. 

Maintenant que nous savons coder une courbe de Bezier, nous allons rajouter deux 
fonctions de dessin : l'une pour dessiner la bouche, l'autre pour dessiner l'oreille. 
Rajoutez le code suivant dans avatar _fonctions.php : 

function dessineOreille ( $conf ) { 
// creer un objet DrawingWand 
$drawing wand = NewDrawingWand () ; 

//creer des PixelWand 

$pxl peau = NewPixelWand () ; 

$pxl contour = NewPixelWand () ; 

PixelSetColor ( $pxl_peau, $conf [ ' couleur_peau' ] ) ; 
PixelSetColor ( $pxl contour, $conf [ ' couleur contour']); 

DrawSetStrokeWidth ( $drawing wand, $conf [ ' epaisseur contour']); 
DrawSetStrokeAlpha ( $drawing wand, $conf [ ' opacite contour']); 

DrawSetFillColor ($drawing wand, $pxl_peau) ; 
DrawSetStrokeColor ( $drawing wand, $pxl contour); 



DrawBezier ( $drawing wand, 


array ( 




132, 150, 


/ /point 


1 


138, 132, 


/ /point 


2 


159, 144, 


/ /point 


3 


150, 165, 


/ /point 


4 


138, 186, 


/ /point 


5 


120, 177, 


/ /point 


6 


126, 168)); 


/ /point 


7 



return $drawing wand; 

} 



function dessineBouche ($conf ) { 
// creer un objet DrawingWand 
$drawing wand = NewDrawingWand () ; 
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//creer un PixelWand 

$pxl contour = NewPixelWand ( ) ; 



PixelSetColor ( $pxl contour, $conf [ ' couleur contour']); 

DrawSetStrokeWidth ( $drawing wand, $conf [ ' epaisseur contour']); 
DrawSetStrokeAlpha ( $drawing wand, $conf [ ' opacite contour']); 

DrawSetFillAlpha ($drawing wand, 0) ; 
DrawSetStrokeColor ( $drawing wand, $pxl contour); 



DrawBezier ( $drawing_wand, array ( 
42, 168, //point 1 

54, 198, //point 2 

111, 192, //point 3 
114, 168) ) ; //point 4 



return $drawing wand; 

} 



Ce n'est pas tres complique, n'est-ce pas ? Notez cependant que nous n'utilisons pas de 
couleur de fond pour la bouche : nous n'avons que le trait du contour... Alors que 
l'oreille est quand meme coloriee avec une couleur, meme si notre forme n'est pas 
fermee. 

Completons notre fichier avatar.php arm qu'il prenne en compte nos nouvelles fonctions 
et dessine effectivement une bouche et une oreille : 

// utilisation des fonctions contenues dans 
// le fichier avatar fonctions . php : 

MagickDrawImage ( $magick wand, dessineTete ( $avatar ) ) ; 
MagickDrawImage ( $magick wand, dessineOreille ($avatar) ) ; 
MagickDrawImage ( $magick_wand, dessineBouche ( $avatar ) ) ; 

Et voila ! Notre magnifique rond se retrouve affuble d'une bouche et d'une oreille. 
Fermer proprement ses courbes de Bezier 

La fonction que nous allons creer maintenant dessinera les cheveux. Vu la complexite de 
la forme, nous allons utiliser une courbe de Bezier que nous allons refermer. Mais 
comment fermer une courbe de Bezier ? Rien de plus facile, observez ce schema : 
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► Fig. 3.16 : 

Une courbe de Bezier 
fermee 



Le dernier point de la courbe est tout simplement le meme que le premier. Voici comment 
nous pourrions coder cette courbe avec MagickWand : 

DrawBezier ($objet drawing wand, array ( 



50, 60, 
90, 100, 
80, 190, 
90, 160, 
100, 130, 
210, 70, 
160, 80, 
110, 90, 
10, 20, 
49, 60)); 



/ / point 1 

/ / point 2 

/ / point 3 

// point 4 

/ / point 5 

/ / point 6 

/ / point 7 

// point 8 

/ / point 9 

// point 10, bouclage 



Comme vous le remarquez justement, le dernier point ne se trouve pas exactement aux 
memes coordonnees que le premier. En effet, si le premier et le dernier point se 
superposent parfaitement, MagickWand fera une petite erreur de rendu. 

Revenons a nos cheveux. Comme nous avons besoin d'un parametre supplementaire, qui 
est la couleur des cheveux, nous allons le rajouter au tableau $avatar du fichier 
avatar.php : 

// tableau des parametres de 1' avatar 
$avatar = Array ( 

' couleur_peau' => "#d4c7a3", 

' couleur_contour' => "#000000", 

' opacite_contour ' => 0.5, 

' epaisseur_contour ' => 3, 
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' couleur_cheveux' => "#985d36" 

) ; 

Ensuite, rajoutez cette fonction dans votre fichier avatar_fonctions.php : 

function dessineCheveux ( $conf ) { 
// creer un objet DrawingWand 
$drawing wand = NewDrawingWand ( ) ; 

//creer des PixelWand 
$pxl cheveux = NewPixelWand () ; 
$pxl contour = NewPixelWand () ; 

PixelSetColor ( $pxl_cheveux, $conf [ ' couleur cheveux']); 
PixelSetColor ( $pxl contour, $conf [' couleur contour']); 

DrawSetStrokeWidth ( $drawing wand, $conf [ ' epaisseur contour']); 
DrawSetStrokeAlpha ( $drawing wand, $conf [ ' opacite contour']); 

DrawSetFillColor ( $drawing_wand, $pxl cheveux) ; 
DrawSetStrokeColor ( $drawing wand, $pxl contour); 

DrawBezier ( $drawing_wand, array ( 

24, 123, //point 1 

35, 68, //point 2 

165, 68, 165, 85, 166, 121, 

144, 183, 141, 180, 132, 174, 

138, 165, 138, 165, 132, 150, 

126, 162, 126, 162, 126, 162, 

111, 162, 117, 156, 120, 138, 

102, 138, 36, 130, 25, 123)); 
return $drawing_wand; 

} 

Et voila ! La fonction DrawBezier () peut sembler effrayante, avec ces coordonnees de 
24 points. Mais fmalement, rien de sorcier, n'est-ce pas ? 

Completons done notre fichier avatar.php arm qu'il dessine aussi les cheveux : 

// utilisation des fonctions contenues dans 
// le fichier avatar fonctions . php : 

MagickDrawImage ( $magick wand, dessineTete ( $avatar ) ) ; 
MagickDrawImage ( $magick wand, dessineCheveux ($avatar) ) ; 
MagickDrawImage ( $magick wand, dessineOreille ($avatar) ) ; 
MagickDrawImage ( $magick_wand, dessineBouche ( $avatar ) ) ; 

Notez que nous utilisons la fonction dessinant les cheveux avant celle dessinant l'oreille. 
Les deux formes se superposant, il faut bien que l'une apparaisse au-dessus de l'autre. 



153, 177, //points 3 a 6 
132, 174, //points 7 a 10 
132, 150, //points 11 a 14 
114, 165, //points 15 a 18 
154, 92, //points 19 a 22 
//points 23 a bouclage 
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C'est done l'ordre dans lequel nous appelons nos fonctions qui va determiner quelle 
forme sera au-dessus. 

Que nous manque-t-il, pour terminer notre avatar ? Les yeux et le nez. Mais vous avez 
deja compris comment les dessiner. Nous allons corser un peu l'exercice en donnant la 
possibilite de parametrer le rayon des yeux. De plus, comme nous avons choisi une pose 
de trois quarts pour le visage de notre avatar, le nez se trouvera, en termes de 
superposition de formes, entre les deux yeux. C'est-a-dire qu'il devra apparaitre 
par-dessus l'oeil droit de notre avatar, et par-dessous l'oeil gauche. Voici comment nous 
nous y prenons pour realiser une telle fonction : 

function dessineYeuxEtNez ($conf ) { 

// creer un objet DrawingWand 
$drawing wand = NewDrawingWand ( ) ; 

//creer des PixelWand 
$pxl oeil = NewPixelWand ( ) ; 
$pxl iris = NewPixelWand () ; 
$pxl contour = NewPixelWand () ; 
$pxl peau = NewPixelWand () ; 

Pixel SetColor ( $pxl_oeil , $conf [ ' couleur_oeil' ] ) ; 
PixelSetColor ( $pxl iris, $conf [ ' couleur iris']); 
PixelSetColor ( $pxl contour, $conf [' couleur contour']); 
PixelSetColor ( $pxl_peau , $conf [ ' couleur_peau' ] ) ; 

DrawSetStrokeWidth ( $drawing wand, $conf [ ' epaisseur__contour ' ] ) ; 
DrawSetStrokeAlpha ( $drawing_wand, $conf [ ' opacite_contour ' ] ) ; 

// 1' oeil droit : 

DrawSetFillColor ($drawing wand, $pxl oeil); 
DrawSetStrokeColor ( $drawing wand, $pxl contour); 
DrawCircle ( $drawing_wand, 

60, 150, //centre 

60, 1 50+$conf [ ' rayon_oeil ' ] ) ; //rayon 
// 1' iris droit : 

DrawSetFillColor ( $drawing wand, $pxl iris); 

DrawCircle ( $drawing_wand, 

63, 150, //centre 

60, 150+ ($conf [' rayon_oeil' ] /4) ) ; //rayon 

// le nez 

DrawSetFillColor ( $drawing wand, $pxl_peau) ; 
DrawBezier ($drawing_wand, array ( 

75, 150, 63, 159, 75, 171, 78, 168)); 
// l'oeil gauche : 



138 



Utiliser ImageMagick et MagickWand 3 



DrawSetFillColor ($drawing wand, $pxl oeil); 

DrawCircle ( $drawing wand, 

90, 150, //centre 

90, 150+$conf [ ' rayon_oeil' ] ) ; //rayon 

// l'iris gauche : 

DrawSetFillColor ($drawing wand, $pxl iris); 
DrawCircle ( $drawing wand, 

93, 150, //centre 

93, 150+ ($conf [' rayon_oeil' ] /4) ) ; //rayon 



return $drawing_wand; 

} 

Naturellement, n'oubliez pas de rajouter les nouveaux parametres (la couleur de l'ceil, 
celle de l'iris et le rayon de l'ceil) dans le tableau $avatar du fichier avatar.php : 

$avatar = Array ( 

' couleur_peau' => "#d4c7a3", 
' couleur_contour' => "#000000", 
' opacite_contour ' => 0.5, 
' epaisseur_contour ' => 3, 
' couleur_cheveux' => "#985d36", 
' couleur_oeil' => "tffffff", 
'couleur iris' => "fcccccc", 
'rayon_oeil' => 16, 

) ; 

Enfin, n'oublions pas, toujours dans le fichier avatar.php, d'utiliser notre nouvelle 
fonction : 

// utilisation des fonctions contenues dans 
// le fichier avatar fonctions . php : 

MagickDrawImage ( $magick wand, dessineTete ( $avatar ) ) ; 
MagickDrawImage ( $magick wand, dessineCheveux ($avatar) ) ; 
MagickDrawImage ( $magick wand, dessineOreille ($avatar) ) ; 
MagickDrawImage ( $magick wand, dessineYeuxEtNez ($avatar) ) ; 
MagickDrawImage ( $magick_wand, dessineBouche ( $avatar ) ) ; 

Programmer un second nez et un second visage 

Nous pouvons deja avoir de nombreux avatars differents, mais ils auront finalement 
toujours la meme tete. Pour remedier a cela, nous allons programmer une seconde forme 
de nez ainsi qu'une seconde forme de visage de maniere a ce que Ton puisse choisir la 
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forme de notre choix directement depuis le tableau $avatar. Commen9ons done par lui 
ajouter quelques parametres : 

// tableau des parametres de 1' avatar 
$avatar = Array ( 

' couleur_peau' => "#d4c7a3", 

' couleur_contour' => "#000000", 

' opacite_contour ' => 0.5, 

' epaisseur_contour ' => 3, 

' couleurcheveux' => "#985d36", 

' couleur_oeil' => "tffffff", 

' couleur iris' => "#cccccc", 

'rayon oeil' => 16, 

'nez' => 1, 

'tete' => 1, 



Modifions maintenant la fonction DessineTete() de notre fichier avatar Jonctions.php : 



function dessineTete ($conf ) { 






// creer un objet DrawingWand 






$drawing wand = NewDrawingWand ( ) ; 






//creer des PixelWand 






$pxl peau = NewPixelWand () ; 






$pxl contour = NewPixelWand () ; 






PixelSetColor ( $pxl peau, $conf [' couleur peau']); 






PixelSetColor ( $pxl contour, $conf [' couleur contour' 


]) 




DrawSetStrokeWidth ( $drawing wand, $conf [ ' epaisseur 


contour' ] ) ; 


DrawSetStrokeAlpha ( $drawing wand, $conf [ ' opacite contour']); 


DrawSetFillColor ($drawing wand, $pxl peau); 






DrawSetStrokeColor ( $drawing wand, $pxl contour); 






switch ($conf [' tete' ] ) { 






case 1 : 






DrawBezier ( $drawing wand, array ( 






42, 129,36, 141,40, 220, //points 


1 


a 3 


40, 220,70, 230,167, 194, //points 


4 


a 6 


167, 150167, 12651, 108, //points 


7 


a 9 


43, 129)); //bouclage 






break; 






default : 






DrawCircle ( $drawing wand, 
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90, 150, 


/ / centre 


90, 205); 


/ / rayon 


break; 

} 




return $drawing wand; 

} 





Grace a l'instruction switch (), le script saura s'il lui faut dessiner une courbe de Bezier 
ou un cercle. Faisons de meme avec la fonction dessineYeuxEtNezQ : 

function dessineYeuxEtNez ( $conf ) { 



// creer un objet DrawingWand 
$drawing wand = NewDrawingWand ( ) ; 

//creer des PixelWand 
$pxl oeil = NewPixelWand () ; 
$pxl iris = NewPixelWand () ; 
$pxl contour = NewPixelWand () ; 
$pxl peau = NewPixelWand () ; 

PixelSetColor( $pxl_oeil , $conf [ ' couleur_oeil ' ] ) ; 
PixelSetColor ( $pxl iris, $conf [ ' couleur iris']); 
PixelSetColor ( $pxl contour, $conf [' couleur contour']); 
PixelSetColor ( $pxl_peau , $conf [ ' couleur_peau' ] ) ; 

DrawSetStrokeWidth ( $drawing wand, $conf [ ' epaisseur contour']); 
DrawSetStrokeAlpha ( $drawing_wand, $conf [ ' opacite contour']); 

// l'oeil droit : 

DrawSetFillColor ( $drawing wand, $pxl oeil); 

DrawSetStrokeColor ( $drawing wand, $pxl contour); 

DrawCircle ( $drawing wand, 

60, 150, //centre 

60, 150+$conf [ ' rayon_oeil' ] ) ; //rayon 

// 1 ' iris droit : 

DrawSetFillColor ($drawing wand, $pxl iris); 
DrawCircle ( $drawing wand, 

63, 150, //centre 

60, 150+ ($conf [' rayon_oeil' ] /4) ) ; //rayon 

// le nez 

DrawSetFillColor ( $drawing wand, $pxl peau) ; 
switch ($conf [' nez' ] ) { 
case 1 : 
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DrawBezier ( $drawing wand, array ( 




75, 150,63, 159,75, 171,78, 


168) ) ; 


break; 




default : 




DrawBezier ($drawing wand, array ( 




72, 150,72, 150,42, 156,42, 


156, 


39, 159,36, 174,45, 174,45, 


174, 


78, 168,78, 168, 




break; 

} 

// l'oeil gauche : 






DrawSetFillColor ( $drawing wand, $pxl oeil); 




DrawCircle ( $drawing wand, 




90, 150, //centre 




90, 1 50 + $conf [' rayon oeil']); //rayon 


// 1' iris gauche : 




DrawSetFillColor ( $drawing wand, $pxl iris); 




DrawCircle ( $drawing wand, 




93, 150, //centre 




93, 150+($conf [ ' rayon_oeil' ]/4) ) 


; //rayon 


return $drawing wand; 

} 





Ainsi, vous pouvez creer a loisir autant de formes d'yeux, de nez, de bouche, etc. 
Ecrire un nom au-dessus de notre avatar 

Pour en finir avec l'objet Drawi ngWand, nous allons voir comment ecrire quelque chose sur 
une image, avec la police de votre choix. 

Commencons done par completer notre tableau $avatar avec les parametres dont nous 
avons besoin pour le texte : 

$avatar = Array ( 

' couleur_peau' => "#d4c7a3", 

' couleur_contour' => "#000000", 

' opacite_contour ' => 0.5, 

' epaisseur_contour ' => 3, 

' couleur cheveux' => "tcccccc", 

' couleur_oeil' => "tffffff", 

' couleur_iris' => "#50bb00", 

'rayon oeil' => 10, 

'nez' => 2, 

'tete' => 1, 

'fond epaisseur contour' => 1, 
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' fond_couleur' => "#aaOOOO", 

' fond_couleur_contour' => "#000000", 

' nom' => "Maurice", 

'taille' => 35, 

'angle' => 10, 

'font' => ' Comic, ttf 

) ; 

En ce qui concerne les polices de caracteres, n'oubliez pas de les copier dans le meme 
repertoire que le fichier qui les utilise, ou d'en indiquer correctement le chemin. 

Et voici, dans le fichier avatar _fonctions.php, le code de la fonction Dessi neNom() : 

function dessineNom ( $conf ) { 

// creer un objet DrawingWand 
$drawing wand = NewDrawingWand ( ) ; 

//creer des PixelWand 

$pxl_f ond_couleur = NewPixelWand () ; 

$pxl fond couleur contour = NewPixelWand () ; 

PixelSetColor ( $pxl fond couleur, 

$conf [ ' f ond_couleur' ] ) ; 
PixelSetColor ( $pxl fond couleur contour, 

$conf['fond couleur contour']); 

DrawSetStrokeWidth ($drawing wand, 

$conf [ ' f ond_epaisseur_contour' ] ) ; 

DrawSetFillColor ( $drawing wand, $pxl fond couleur); 
DrawSetStrokeColor ($drawing wand, 

$pxl fond couleur contour) ; 

// la taille du texte en pixels : 
DrawSetFontSize ( $drawing wand, $conf [' taille' ]) ; 
/ / choix de la font : 

DrawSetFont ( $drawing wand, $conf [ ' f ont ' ] ) ; 

// changer 1' orientation du systeme de coordonnees : 

DrawRotate ( $drawing_wand, $conf [' angle' ] ) ; 

// Cet objet MagickWand ne nous servira a rien d' autre 
// qu'a 1' utilisation des fonctions MagickGetStringWidth ( ) 
// et MagickGetStringHeight ( ) 
$magick_tmp = NewMagickWand ( ) ; 

// La fonction MagickGetStringWidth ( ) nous permet de savoir 

// quelle sera la largeur (en pixel) de la chaine de caracteres 
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// contenue dans $conf['nom'] : 

$largeurTexte = MagickGetStringWidth ( $magick tmp, 

$drawing wand, $conf [ ' nom' ] ) ; 
// Pareil, mais pour la hauteur de la chaine de caracteres : 
$hauteurTexte = MagickGetStr ingheight ( $magick tmp, 
$drawing wand, $conf [ ' nom' ] ) ; 



/ / Determiner les coordonnees de 
/ / notre chaine de caracteres : 
$posX = (180-$largeurTexte) 12; 
$posY = 10+$hauteurTexte; 



/ / Dessiner la chaine de caracteres : 
DrawAnnotation ( $drawing wand, 
$posX, $posY, 
$conf [ ' nom' ] ) ; 



return $drawing_wand; 



Pour terminer, voici quelques exemples d' avatars crees avec ce code : 

Fig. 3.17: 

Maurice 
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3.4 Check-list 

Dans ce chapitre, vous avez pu aborder la gestion des images et vous avez pu decouvrir 
qu'il est possible de generer des images a la volee. Nous avons vu : 

</ comment creer des images avec GD2 ; 

«/ comment les redimensionner, les signer, les convertir ; 

comment faire des montages et des incrustations ; 
«/ comment dessiner sur des images 

*/ comment appliquer des effets sur vos images avec ImageMagick et MagickWand ; 
«/ comment realiser des dessins complexes. 
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4.1 Telecharger et utiliser FPDF 

4.2 A propos des pages 

4.3 Importer une police de caracteres 

4.4 Signer un document PDF 

4.5 Check-list 



Generer 
des fichiers 
PDF 




La classe FPDF permet de generer un document PDF 
grace d PHP. Ce document s'ouvrira dans le navigateur 
de I'utilisateur ou dans son lecteur PDF. Cette extension tres 
pratique vous permettra de creer dynamiquement des 
documents de toute nature, que I'utilisateur pourra 
conserver et diffuser independamment. 
FPDF est une classe libre, que vous pourrez utiliser dans 
vos projets commerciaux ou non. 
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4.1 Telecharger et utiliser FPDF 

Vous pouvez telecharger FPDF sur le site http://www.fpdf.org. A l'heure ou ces lignes sont 
ecrites, nous en sommes a la version 1.53. Creez un repertoire chap04, puis un repertoire 
fpdf a l'interieur. Et voila, FPDF est installe. 

Pour utiliser FPDF, il vous faudra, a chaque fichier l'utilisant, importer la classe FPDF : 

require ( ' fpdf/ fpdf . php' ) ; 



Tout au long de ce chapitre, nous allons travailler autour d'un seul petit programme, que 
nous ferons evoluer petit a petit. Ce petit programme aura pour but de generer un fichier 
PDF representant un releve de compte. Creez done, dans votre repertoire chap04, un 
nouveau fichier que vous appellerez fpdfjbanque.php, et completez-le de la maniere 
suivante : 

J^jt fpdf_banque.php 

<?php 

require ( ' fpdf/ fpdf . php' ) ; 

//Creer une instance de FPDF 
$pdf=new FPDF ( ) ; 

//Ajouter une page 
$pdf->AddPage ( ) ; 

//envoyer a la sortie standard 

$pdf->Output ( ) ; 

?> 

Si vous lancez tout de suite ce fichier depuis votre navigateur favori, vous vous trouverez 
face a un splendide document PDF, en mode Portrait et au format A4, entierement vide. 
Vous vous en doutiez, ce n'est que le debut du chapitre... 

Vous pouvez remarquer que nous n'appelons pas la fonction header (), pour l'en-tete http. 
En effet, e'est FPDF qui s'en charge. 

Nous commencons par importer le contenu du fichier fpdf.php, e'est-a-dire le fichier 
contenant la classe FPDF que nous allons utiliser. 



Creer un document 
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La creation d'un nouveau document 

Un document se cree tout simplement par l'appel du constructeur new FPDF(). C'est par 
cet appel que nous definissons les dimensions de notre document, son unite de mesure de 
base, ou son orientation (Portrait ou Paysage). Le constructeur dispose de trois parametres, 
facultatifs, qui vont vous permettre de creer le nouveau document de vos reves : 

FPDF([chaTne $orientation (, chaTne $unite [, mixe $di mens ion]]] ) 

Le premier parametre du constructeur, $orientation, definit 1' orientation de vos pages. 
Non renseigne, votre document prendra l'orientation Portrait par defaut. Cette chaine de 
caracteres peut prendre les valeurs suivantes : 

1 P 1 : portrait ; 

1 L 1 : paysage (landscape). 

Le deuxieme parametre, $unite, definit l'unite de notre systeme de coordonnees. L'unite 
par defaut est le millimetre, mais vous pouvez aussi choisir une autre unite parmi les 
suivantes : 

l ' pt ' : point (il faut 72 points alignes pour faire une ligne de 1 pouce, soit 2,54 cm) ; 
'mm' : millimetre ; 
1 cm 1 : centimetre ; 
'in': pouce. 

Le dernier parametre, $dimension, vous permet de specifier les dimensions de votre 
document. Vous pouvez le renseigner avec un tableau contenant des nombres flottants 
representant la largeur et la hauteur dudit document. Ces nombres seront interpreted avec 
l'unite que vous avez choisie. Vous pouvez aussi renseigner ce parametre avec une des 
chaines de caracteres suivantes : 

■ 'A3' ; 

■ ' A4 ' ; 

■ ' A5 ' ; 

■ 'Letter' ; 

■ 'Legal 1 . 

Faire sortir son document 

Regardons maintenant la fonction Output (). Sans aucun parametre, elle se contente de 
renvoyer notre document sur la sortie standard c'est-a-dire, le plus souvent, le navigateur. 
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Cette fonction dispose de deux parametres, nous permettant de donner un nom au fichier, 
puis de savoir si on l'enregistre localement ou si on l'envoie sur le navigateur de 
l'utilisateur, ou encore si on lui propose de telecharger le document. 

Le premier parametre est une chaine de caracteres donnant un nom de fichier a notre 
document. Modifiez votre code comme ceci : 

$pdf->Output ("fichier.pdf") ; 

Si vous executez votre fichier, rien n'apparaitra dans le navigateur. Le plug-in 
Acrobat Reader ne se lancera meme pas. Par contre, votre document aura ete enregistre 
sur votre disque, sous le nomfichier.pdf. Vous pouvez influer sur cette action en specifiant 
le deuxieme parametre. II s'agit d'une chaine de caracteres pouvant prendre les valeurs 
suivantes : 

1 1 1 : envoie au navigateur. Si l'utilisateur decide d'enregistrer le document sur son 
disque, le nom propose sera celui que vous aviez indique avec le premier parametre. 
1 D 1 : propose le fichier en telechargement a l'utilisateur. 

1 F 1 : enregistre le fichier localement, avec le nom propose par le premier argument. 
1 S 1 : renvoie le document sous la forme d'une chaine de caracteres. 

Si aucun parametre n'est renseigne, la fonction envoie le document au navigateur. Si seul 
le deuxieme parametre est omis, la fonction enregistre le fichier localement. 

Pour continuer ce chapitre et faire en sorte que votre document apparaisse dans votre 
navigateur, il vous faut modifier a nouveau votre fichier en enlevant 1' argument que vous 
venez d'ajouter a la fonction Output (). 

Placer des images 

A present, il est temps de commencer a remplir notre document. Traditionnellement, nous 
vous ferions ecrire une petite phrase, mais placer une image est tellement simple que c'est 
ce que nous allons faire. Juste apres l'appel a la fonction AddPageQ de votre fichier 
fpdfjbanque.php, ajoutez la ligne suivante : 

//Poser une image : 

$pdf->Image ( ' redf ish .png' , 5, 5, 50); 

Voici la fonction ImageQ. Concretement, elle va afficher l'image passee au premier 
argument dans notre document. Elle placera le coin superieur gauche de notre image au 
point de coordonnees (5, 5), et dimensionnera sans la deformer (en respectant 
l'homothetie) notre image de maniere a ce qu'elle fasse 50 unites (dans notre exemple, 
l'unite est le millimetre) de large. La hauteur de l'image sera adaptee. 
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(j) Le systeme de coordonnees 

Avec FPDF, I'origine de notre systeme de coordonnees se trouve dans le coin superieur gauche de la 
page PDF. 

Les types d'images que vous pouvez utiliser sont le JPEG et le PNG. 



fpdf_banque.php (Ob jet application/pdf) - MozilLa Firefox 
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Fig. 4.1 : Notre image 

Placer du texte 

Nous allons, avant de commencer a ecrire du texte sur notre document PDF, creer un 
nouveau fichier appele fpdf_donnees.php. Ce fichier contiendra toutes les donnees que 
nous inscrirons dans notre document PDF. Le fait qu'il soit separe de fpdfjbanque.php 
nous permettra de changer ces donnees plus facilement. Voici done la premiere de nos 
donnees, a mettre dans le fichier fpdf_donnees.php : 



<?php 
$titre = 
?> 



'RELEVE DE COMPTE" ; 
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N'oubliez pas de preciser, dans fpdf_banque.php, que nous allons utiliser des donnees 
provenant d'un autre fichier : 

<?php 

require ( ' f pdf / f pdf . php' ) ; 
include ' fpdf donnees . php' ; 



A present, nous allons ecrire le premier texte dans notre document. Toujours dans le 
fichier fpdf '_banque.php, inserez les lignes suivantes juste apres l'appel de l'image : 

//Ecrire une chaine 
$pdf->SetFont ('Arial' , 'B' , 16) ; 
$largeur = $pdf ->GetStringWidth ( $titre ) ; 
$pdf->SetX (105- ($largeur/2) ) ; 
$pdf->Cell ($largeur, 0, $titre); 



Si vous lancez ce fichier maintenant, vous allez voir votre titre apparaitre. 



•t) fpdfbanque.php (Ob jet application/pdf) - Mozilla Firefox 
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RELEVE DE COMPTE 



Fig. 4.2 : Votre premier texte 
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Definir la police de caracteres 

Mais que se cache-t-il, dans ces quatre lignes de code ? Tout d'abord, nous definissons la 
police de caracteres courante grace a la fonction Set Font (). Le premier des trois 
arguments de cette fonction precise, d'une chaine de caracteres, quelle famille de police 
utiliser. Les families disponibles sont les suivantes : 

1 1 : chaine vide : aucune police, ou bien conserve la police precedente. 
■ 'Courier' 
'Arial 1 
'Helvetica' 
'Times' 
' Symbol ' 
'Zapf Dingbats' 

Le deuxieme parametre indique le style de la police. II peut prendre les valeurs suivantes : 

' ' : chaine vide : style normal. 
' B ' : votre texte sera ecrit en gras. 
' I ' : votre texte sera ecrit en italique. 
' U ' : votre texte sera souligne. 

Vous pouvez aussi ecrire ' BI U ' , votre texte sera en gras italique souligne. Ou alors 
'UB', votre texte sera ecrit en gras et souligne... 

Enfin, le troisieme parametre indique la taille de la police, en point. Dans notre exemple, 
et ce jusqu'au prochain appel de la fonction SetFontQ, nos textes seront ecrits en Arial, 
gras, et auront une taille de 16 pt. 

Positionner une chaine : connaitre sa largeur 

Comme nous souhaitons centrer notre titre, et qu'il n'existe pas vraiment de fonction faite 
specialement pour cela, il nous faut savoir quelle est la largeur de notre chaine de 
caracteres $titre, lorsqu'elle est ecrite en Arial, gras, et avec une taille de 16 pt. C'est 
tout simplement ce que se propose de faire la fonction GetStri ngWidth(). Nous 
recuperons le resultat qu'elle nous renvoie dans la variable $largeur. 

Nous allons utiliser la fonction SetX() pour defmir le point de coordonnees courant, 
c'est-a-dire le point a partir duquel nous allons ecrire, dessiner, ou placer une image. Ce 
n'est pas la peine d'utiliser la fonction SetY() (ou la fonction SetXYQ), car le point de 
coordonnees courant est deja verticalement defini en accord avec nos souhaits. 
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Ecrire le texte 

Nous avons determine notre police de caracteres ainsi que 1'emplacement de notre texte. 
II ne nous reste plus qu'a l'ecrire. A cet effet, nous utilisons la fonction Cell (). Voici 
comment nous 1' avons mise en scene : 

$pdf->Cell ($largeur, 0, $titre); 

En fait, notre texte va se placer a l'interieur d'une cellule. Le premier argument de cette 
fonction defmit done la largeur de cette cellule, et le deuxieme sa hauteur. Une hauteur 
de mm n'est, pour le moment, pas encore un probleme. Le troisieme argument est, bien 
sur, la chaine de caracteres a ecrire sur le document. 

Ecrivons une deuxieme chaine. Commencez par creer, dans votre fichier fpdf_donnes.php, 
la variable $dateReleve contenant la chaine de caracteres que nous allons afficher. 
Ensuite, ajoutez ces lignes dans fpdfjbanque.php : 

//Ecrire une chaine 
$pdf->SetFont ('Arial' , ' I' , 12) ; 

$largeur = $pdf ->GetStringWidth ( $dateReleve ) ; 
$pdf->SetXY (105, 10); 

$pdf->Cell ($largeur, 10, $dateReleve) ; 



*9 fpdf_banque.php (Objet application/pdf) - MozilLa Firefox 
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RELEVE DE COMPTE 

Du 19/09/2007 su 18/10/2007 



► Fig. 4.3 : Un deuxieme texte ! Mais jusqu'ou ira-t-on ? 
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Ecrire des blocs de texte 

Pour le moment, nous n'avons ecrit du texte que sous forme de lignes, mais il est possible 
de le faire sous forme de paragraphes : les blocs de texte. Nous allons done creer, dans fpdf_ 
donnees.php, une variable $adresse contenant une chaine de caracteres suffisamment longue 
pour pouvoir constituer un paragraphe. Voici celle que nous utilisons dans notre exemple : 

$adresse = "M. Moutarde Colonel, \n Chez le Dr. Lenoir\n"; 
$adresse .= "25 rue de la Salle de Billard\n"; 
$adresse .= "14320 Avec-Le-Chandelier"; 

Vous pouvez noter la presence, dans notre chaine, du caractere de retour chariot 1 \ n 1 , afin 
de signifier les endroits ou nous demandons explicitement a retourner a la ligne. 

Ajoutons maintenant, dans fpdfjbanque.php, de quoi constituer notre paragraphe : 

//Ecrire un paragraphe 
$pdf->SetXY (105, 30); 
$pdf->SetFont ('Courier' , " , 12) ; 
$pdf->Multicell (80, 5, $adresse) ; 

Et voila. II n'y a rien de complique, si ce n'est que nous utilisons la fonction Mul ti eel 1 () 
au lieu de Cel 1 (). 



Q fpdf banque.php [Ob jet application/pdf) - Mozilla Fire fox 
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RELEVE DE COMPTE 



Du 19/09/2007 au 13/10/2007 



M. Moutarde Colonel, 
Chez le Dr. Lenoir 
25 rue de la Salle de Billard 
14320 Avec-Le-Chandelier 



Fig. 4.4 : Un bloc de texte 
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(J) La hauteur de la cellule 

Un bloc de texte est fait de plusieurs cellules a la suite. II est done important de specifier une hauteur 
pour ces cellules. Si vous laissez le deuxieme parametre de la fonction MulticellO a 0, toutes vos 
lignes s'ecriront les unes par-dessus les autres. En somme, la hauteur de la cellule est ce qui sert de 
reference a FPDF pour savoir ou placer une ligne (cellule) par rapport a la ligne precedente. 



Centrer, justifier ou aligner sur la droite le contenu d'un bloc de texte 

Eh oui, la fonction Multicell () est assez complete ! En plus, cela se fait simplement. 

Comme nous avons besoin d'une nouvelle chaine de caracteres pour le nouveau 
paragraphe que nous allons faire, nous vous laissons le soin d'en creer une dans le fichier 
fpdf_donnees.php (dans une variable $parCentre). Voici celle que nous utilisons dans 
notre exemple : 



$parCentre 
$parCentre 
$parCentre 
$parCentre 
$parCentre 
$parCentre 
$parCentre 
$parCentre 
$parCentre 



'La banque \"RedFish\" - la banque a qui on 
"fait confiance - est tres tres fiere, "; 
"de vous presenter son "; 

"nouveau service de releves de comptes " ; 
"en ligne !\n***\nUn service entierement " ; 
"dynamique qui nous permet de vous faire "; 
"des releves de comptes quand vous le " ; 
"souhaitez, et couvrant la periode de "; 
"votre choix ! \nTrop chouette, hein ?! ! " ; 



Voyons maintenant le code a ajouter a fpdf_banque.php : 

//Ecrire un paragraphe centre 
$pdf->SetXY (45, 60); 
$pdf->SetFont ('Arial' , " , 10) ; 
$pdf->Multicell (120, 5, 

utf 8_decode ( $parCentre ) , 

0, 'C); 



Comme vous pouvez le constater, nous avons rajoute deux arguments a la fonction 
Mul ti eel 1 () . Celui qui vaut (1' avant-dernier argument) signifie que nous ne voulons pas 
de cadre a notre paragraphe (nous parlerons des cadres un peu plus loin). Le dernier 
parametre est en fait une chaine de caracteres qui indique comment aligner le texte de 
votre paragraphe. Cette chaine peut prendre les valeurs suivantes : 

1 L 1 : votre paragraphe est aligne a gauche. 
1 R 1 : votre paragraphe est aligne a droite. 
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centrer le texte du paragraphe. 



1 C 1 : pour w 

1 J 1 : pour justifier le texte du paragraphe. 
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RELEVE DE COMPTE 

Du 79/09/2007 au fS//0/20O7 



M. Moutarde Colonel,, 
Chez le Dr. Lenoir 
2 5 rue de la Salle de Billard 
1432 Avec-Le-Chandelier 



La banque "RedFish" - la banque a qui on fait confiance - est tres tres fiere, 
de vous presenter son nouveau service de releves de comptes en ligne ! 

Un service entierement dynamique qui nous permet de vojs faire des 
releves de comptes quand vous le souhaitez, et couvrant la periode de 
votre choix ! 
Trap super chouette, hein ?!! 



I Done 



Fig. 4.5 : Un paragraphe ou le texte est centre. 

Des lignes et des colonnes : faire un tableau 

Nous allons examiner un peu plus en detail ce que Ton peut faire avec une cellule. Pour 
le moment, notre point de coordonnees courant se trouve a la fin du paragraphe que nous 
venons d'ecrire. Nous allons commencer par effectuer un retour chariot (sauter une ligne), 
de maniere a ce que notre point de coordonnees courant se trouve une ligne en dessous 
de notre paragraphe, et le long de la marge de gauche (c'est-a-dire a 1 cm du bord 
gauche). 
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(D Les marges 

II existe une marge de 1 cm de cote, le long des quatre bords de notre page. Lorsque le point de 
coordonnees courant est deplace automatiquement, il prend en compte la marge pour definir sa 
nouvelle position. Lorsque vous utilisez les fonctions SetX(), SetY() ouSetXY() pour changer le point de 
coordonnees courant, vous pouvez passer outre les marges (et c'est d'ailleurs ce que nous avons fait 
lorsque nous avons place notre image). 

Ajoutez la ligne suivante a la suite de fpdfjxmque.php : 

//sauter une ligne 
$pdf->Ln (4) ; 

La fonction Ln ( ) effectue un retour chariot. Le parametre determine la hauteur de la ligne 
a sauter (ici, 4 mm. Attention : si 1' unite que vous avez choisie est le point, notre ligne 
ne fera pas 4 mm de hauteur, mais 4 pt). Si on ne precise pas la hauteur de la ligne a 
sauter, celle-ci prendra automatiquement pour valeur la hauteur de la ligne precedente. 

Ann de realiser notre tableau, nous allons entrer de nouvelles donnees dans le fichier 
fpdf_donnees.php : 

$ancienSolde = 100; 

$operation = array ( 
array ( 

'date' => "19/09", 

'nature' => 'Cotisation mensuelle' , 
'debit' => 10 

) , 

array ( 

'date' => "20/09", 
'nature' => 'Carte bleue' , 
'debit' => 32.5 

) , 

array ( 

'date' => "20/09", 

'nature' => 'Commerce electronique' , 
'debit' => 26.10 

) , 

array ( 

'date' => "21/09", 

'nature' => ' Trouve par terre' , 

'credit' => 50 

) , 

) ; 



158 



Telecharger et utiliser FPDF 



4 



La moindre des choses sur un releve de compte, avant meme de commencer le tableau des 
operations, c'est de rappeler a l'usager le solde restant sur son compte. Rajoutons done 
ces quelques lignes dans notre flchier fpdfjbanque.php : 

$soldePrecedent = "Solde precedent : " . $ancienSolde; 
$pdf->SetFont ('Arial' , 'B' , 12) ; 

$pdf->Cell (100, 0, utf 8_decode ( $ soldePrecedent ) ) ; 

Attaquons-nous a la premiere ligne de notre tableau : les en-tetes de colonnes. Ajoutez le 
code suivant a fpdfjbanque.php : 

/ / saut de ligne 
$pdf->Ln(4) ; 

// On tableau 

//Les en-tetes 

$pdf ->SetLineWidth (0.4); 

$pdf->SetX(10) ; 

$pdf->Cell (15, 5, 'Date', 1, 0, 'C'); 
$pdf->Cell (115, 5, 

utf 8_decode (' Nature de IV operation' ) , 

1, 0, 'C'); 
$pdf->Cell (30, 5, utf8_decode (' Debit' ) , 

1, 0, 'C'); 
$pdf->Cell (30, 5, utf 8_decode ('Credit' ) , 

1, 0, 'C'); 

Tout d'abord, nous appelons la fonction SetLineWidth(), qui nous permet de choisir une 
epaisseur pour nos traits. Ensuite, nous appelons la fonction SetX(), afin d'etre sur de la 
position du point de coordonnees courant. C'est seulement apres que nous commencons 
a placer les cellules. Nous pouvons deja voir que nous ne touchons pas au point de 
coordonnees courant : des qu'il a fini une cellule, il se positionne automatiquement a la 
suite de celle-ci, pret a en demarrer une autre ! 

Dernier petit detail : le quatrieme parametre est a 1 , ce qui signifie que chaque cellule va 
se retrouver habillee par une bordure de 1' epaisseur precisee par la fonction 
SetLineWidth(). Regardez done votre travail depuis votre navigateur prefere. 
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RELEVE DE COMPTE 

Du 19/09/2007 au 18/10/2007 



M. Moutarde Colonel, 
Chez le Dr. Lenoir 
25 rue de la Salle de Billard 
14320 Avec-Le-Chandelier 



La barque "RedFish" - la banque a qui on fait contraries - est tres tres fiere, 
de vous presenter son nouveau service de releves de comptes en ligne I 

Un service entierement dynamique qji nous permet de vous faire des 
releves de comptes quand vous le souha.ir.ez, et couvrant la periode de 
votre choix I 
Trap super chouette, hein ?!! 



Solde precedent : 100 



Date 



Nature de I'operation 



Debit 



Credit 



1 

I Done 



► Fig. 4.6 : Des cellules encadrees 

Les lignes du tableau 

Nous avons, dans le fichier fpdf_donnees.php, cree la variable $operation, qui est en fait 
un tableau contenant toutes les operations que nous allons lister maintenant. Voici le code 
a aj outer au fichier fpdfjbanque.php : 

//les lignes 

$pdf->SetFont ( ' Arial' , " , 12 ) ; 
$pdf->SetFillColor (230, 230, 230); 

$mouvementDebit = ; 
$mouvementCredit = 0; 



for($i = ; $i < count ( $operation) ; $i++) { 
$pdf->Ln ( ) ; 
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//definit s'il faut remplir cette ligne 
//avec la couleur de remplissage ou non . 
$remplir = ; 

if ($i % 2 != 0) { 
$remplir = 1 ; 

} 

//Cellule 'Date' 

$pdf->Cell (15, 5, $operation [$i] ['date' ] , 'L', 0, 'C, $remplir) ; 
//Cellule 'Nature' 

$pdf->Cell (115, 5, utf8_decode ($operation [$i] [ 'nature' ]) , 'L', 0, 'L', 

$remplir) ; 
//Cellule 'Debit' 

$pdf->Cell (30, 5, utf8_decode($operation[$i] ['debit' ]) , 'L', 0, 'R', 
$remplir) ; 

$mouvementDebit += $operation [ $i ] ['debit']; 
//Cellule 'Credit' 

$pdf->Cell (30, 5, utf8_decode ($operation [$i] [' credit' ]) , ' LR' , 0, ' R' , 
$remplir) ; 

$mouvementCredit += $operation [ $i ][' credit' ] ; 

} 

La fonction SetFi 1 ICol or() que nous utilisons ici permet de definir la couleur de 
remplissage par defaut. Les parametres sont des nombres compris entre et 255 et servent 
a definir la proportion de couleur pour chacune des trois composantes de la lumiere. Le 
premier parametre decrit la composante rouge, le deuxieme la composante verte, et le 
troisieme la composante bleue. 

Le reste du code se passe dans la boucle for : nous commencons par sauter une ligne 
(fonction Ln ( ) ) puis, grace a un petit test if, nous determinons si le numero de la ligne 
est pair ou impair. Cela nous sera utile pour colorer le fond d'une ligne sur deux. 

Viennent alors les cellules en elles-memes. Nous observons tout d'abord que le quatrieme 
parametre de la fonction Cel 1 (), celui qui sert a mettre ou non la bordure, n'est plus un 
entier, mais une chaine de caracteres. Voici les differentes valeurs que peut prendre ce 
quatrieme parametre : 

: pas de bordure. 

1 : la bordure est presente. 

1 L 1 : (comme left) seulement la bordure droite de notre cellule. 
1 T 1 : (comme top) seulement la bordure superieure de notre cellule. 
1 R 1 : (comme right) seulement la bordure droite de notre cellule. 
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1 B 1 : (comme bottom) seulement la bordure inferieure de notre cellule. 
Vous pouvez aussi utiliser plusieurs de ces lettres. Par exemple, la chaine 1 LR 1 (ou 
la chaine 1 RL 1 , l'ordre n'a pas d'importance) fera apparaitre la bordure sur les cotes 
gauche et droit de notre cellule. 

Enfin, un dernier parametre a fait son apparition au sein de la fonction Cel 1 (). Parametre 
a 1 ou a 0, il definit si oui (1) ou non (0) la cellule doit etre remplie avec la couleur de 
remplissage courante ; ce qui nous permet d'alterner les lignes colorees avec celles non 
colorees. 
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RELEVE DE COMPTE 

Dtt 19/09/2007 an 18/10/2007 



M . Moutarde Colonel , 
Chez le Dr. Lenoir 
2E rue de la Salle de Billard 
14320 Avec-Le-Chandelier 



La barque "RedFish" - la barque a qui on fait confiance - est tres tres fiere, 
de vous presenter son nouveau service de releves de comptes en ligne I 

Un service entierement dynamique qji nous permet de vous faire des 
releves de comptes quand vous le souhaitez, et couvrant la periode de 
votre choix I 
Trap super chouette, hein ?!! 



Solde precedent : 100 



Dace 


Nacu re de I 'operation 


Debit 


Credit 


19/09 


Cotisation mensuelle 


10 




20/09 


Carte Bleue 


32.5 




20/09 


Commerce electronique 


26 1 




21/09 


Trouve parterre 




50 



Fig. 4.7 : Les lignes du tableau 
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Finir le tableau 

Nous avons pratiquement termine le tableau. D'ailleurs, avec les connaissances que vous 
avez acquises, vous devriez etre capable de terminer tout seul ce tableau. Voici neanmoins 
comment nous nous y prenons : 

//Derniere ligne 
$pdf->SetFont ('Arial' ,'B' ,12) ; 
$pdf->Ln ( ) ; 
$rempli = 0; 

if (count ( $operation) % 2 != 0){ 
$rempli = 1 ; 

} 

//Cellule 'Date' 

$pdf->Cell (15, 5, ", 'LB', 0, 'C, $rempli); 
//Cellule 'Nature' 
$repere = $pdf->GetX ( ) ; 

$pdf->Cell (115, 5, 'TOTAUX DES MOUVEMENTS', 'LB', 0, ' R' , $rempli); 
//Cellule 'Debit' 

$pdf->Cell (30, 5, $mouvementDebit, 'LB', 0, 'R', $rempli) ; 
//Cellule 'Debit' 

$pdf->Cell (30, 5, $mouvementCredit, ' LBR' , 0, 'R', $rempli); 

//ligne "nouveau solde" 
$pdf->Ln ( ) ; 
$pdf->SetX ( $repere ) ; 

$pdf->Cell (115, 5, ' NOUVEAU SOLDE', 0, 0, ' R' ) ; 
//calcul du nouveau solde 

$nouveauSolde = $mouvementCredit-$mouvementDebit+$ancienSolde ; 
$celluleDebit = " ; 
$celluleCredit = " ; 
if ( $nouveauSolde < 0){ 

$celluleDebit .= $nouveauSolde ; 
} else { 

$celluleCredit .= $nouveauSolde; 

} 

$pdf->Cell (30, 5, $celluleDebit, 0, 0, ' R' ) ; 
$pdf->Cell (30, 5, $celluleCredit, 0, 0, 'R'); 

Comme vous pouvez le constater, nous avons deja utilise et explique toutes les fonctions 
presentes dans ce bout de code. Admirez done le resultat de votre travail. Et profltez-en 
pour le personnaliser ou le peaufiner. 
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RELEVE DE COMPTE 

Dtt 19/09/2007 au 18/10/2007 



M. Houtarde Colonel , 
Chez le Dr. Lenoir 
2 5 rue de la Salle de Billard 
14320 Avec-Le-Chandelier 



La barque "RedFish" - la banque a qui on fait confiance - est tres tres fieire, 
de vous presenter son nouveau service de releves de ccmptes en ligne ! 

Un service entieremerrt dynamique qui nous permet de vous faire des 
releves de comptes quand vous le souhaitez : et couvrant Ea periode de 
votre choix I 
Trap super chouette, hein ?!! 



Solde precedent : 100 



Date 


Nature de I'operation 


Debit 


Credit 


18/09 


Cotisation mensuelle 


10 




20/09 


Carte Bleue 


32.5 




20/09 


Commerce electronique 


26 1 




21/09 


Trouve parterre 




50 




TOTAUX DES MOUVEMENTS 


68.6 


50 



NOUVEAU SOLDE 



81.4 



Fig. 4.8 : Notre tableau estfini 



4.2 A propos des pages 

Un document PDF peut etre compose d'une ou plusieurs pages. Nous avons deja vu la 
fonction AddPage() (au tout debut de ce chapitre), qui nous permet justement de rajouter 
une page. II existe cependant un moyen de rajouter une page implicitement. 

Dans votre fichier fpdf_donnees.php, veuillez ajouter une quinzaine d' entrees au tableau 
$operation, puis relancez le fichier fpdfjbanque.php dans votre navigateur. 
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20/oa 


Carte Bleue 


32.5 




20/09 


Commerce electranique 


26.1 




21/09 


Trouve parterre 




50 


22/09 


Mange dehors 


15 




23/09 


Perdu dans ia me 


15 




19/09 


CoTisniki-^ mensuelle 


10 




20/09 


Carte Bleue 


32.5 





20/09 


Commerce electranique 


26.1 




21/09 


Trouve par terre 




50 


22/09 


Mange dehors 


15 




23/09 


Perdu dans Da rue 


15 






TOTAUX DES MOUVEMENTS 


691 .6 


300 






NOUVEAU SOLDE 


-191. S 





Fig. 4.9 : Creation d'une page automatique 



Comme vous le constatez, notre tableau est a present trop grand pour ne tenir que sur la 
premiere page. FPDF va done creer une seconde page. II en sera de meme pour un bloc 
de texte. 



Un petit peu de dessin 

Comme tous les logiciels generant du PDF, FPDF dispose de quelques fonctions de 
dessins, que nous allons examiner. A la toute fin de votre fichier fpdf_banque.php (avant 
l'appel a la fonction Output ()), ajoutez le code suivant : 

//Ajouter une page 
$pdf->AddPage ( ) ; 

$pdf->SetDrawColor (100, 100, 100); 

//dessiner un rectangle 

$pdf->Rect (10, 10, 190, 277, ' DF' ) ; 

//dessiner une ligne 
$pdf ->SetLineWidth ( 1 ) ; 
$pdf->Line (20, 20, 190, 277); 
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Nous commencons par utiliser la fonction SetDrawCol or(), dont le but est d'allouer une 
couleur de trace courante. Elle s'utilise avec les trois composantes couleurs de la lumiere 
(rouge, verte et bleue), exactement comme son homologue Set Fi 1 1 Col or () . 

Nous utilisons ensuite la fonction Rect() qui dessine un rectangle. Dans notre exemple, 
le coin superieur gauche du rectangle est place au point de coordonnees (10, 10), comme 
l'indiquent les deux premiers arguments. Notre rectangle fait aussi 190 mm de largeur 
(troisieme argument) sur 277 de hauteur (quatrieme parametre). Le dernier parametre 
indique comment colorer notre rectangle. II peut prendre les valeurs suivantes : 

1 D 1 ou 11 (chaine vide) : dessine seulement le contour du rectangle (utilise la couleur 
de trace courante). 

1 F 1 : remplit le rectangle avec la couleur de remplissage courante, mais ne dessine 
pas son contour. 

I ' DF ' ou 1 FD 1 : remplit le rectangle avec la couleur de remplissage courante, et 
dessine son contour avec la couleur de trace courante. 

Enfin, nous appelons la fonction Line() qui, comme son nom l'indique, trace une ligne avec 
la couleur de trace courante. Les deux premiers arguments de cette fonction definissent les 
coordonnees du point de depart de notre ligne, et les deux derniers, le point d'arrivee. 
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Nous avons fait le tour des fonctions de dessins de FPDF. Comme vous avez pu le 
constater, il existe seulement deux fonctions pour dessiner, ce qui est effectivement tres 
limite. Mais PDF n'a pas ete concu pour dessiner. Et puis, rien ne vous empeche de 
concevoir des images et des graphiques avec GD2 ou MagickWand, pour etayer ensuite 
vos documents PDF. 

Vous pouvez vous referer au chapitre Manipuler des images pour plus de details 
sur Vutilisation de MagickWand ou de GDI. 

En-tetes et pieds de page 

II existe, dans FPDF, deux fonctions qui sont appelees a chaque creation de page. II s'agit 
des fonctions HeaderQ et Footer(). Enfin, elles existent, mais... elles sont vides. 

En fait, nous avons la possibility de surcharger ces fonctions, de maniere a etablir un 
en-tete et un pied de page en accord avec votre document, son nombre de pages, etc. 

Comme il nous faut surcharger ces deux fonctions, nous allons creer une classe derivant 
de FPDF dans un nouveau fichier, fpdf_classe.php, que voici : 



fpdf_classe.php 

<?php 

require ( ' f pdf / f pdf . php' ) ; 

class PDF extends FPDF { 
//En-tete 

function Header (){ 

$this->SetFont (' Arial' , ' I' , 8) ; 
$this->SetXY (2 . 5, 2.5); 
$this->Cell (30, 0, ' Banque RedFish' ) ; 
$this->SetXY (10, 10); 

} 

//Pied de page 
function Footer (){ 

//Positionnement a 10mm du bas 

$this->SetXY (5, -10); 

$this->SetFont ('Arial' , ' I' , 8) ; 

/ /Numero de page 

$this->Cell (0,10,' Page ' . $this->PageNo ( ) . ' / { nb } ' , , , ' C ) ; 

} 

} 

?> 
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Rien de difficile : nous nous contentons de deriver la classe FPDF en une nouvelle classe 
appelee PDF, puis nous redefinissons simplement les fonctions Header () et Footer (). 
Ainsi, nous precisons dans la fonction Header () que nous voulons un texte ecrit en Arial, 
italique, 8 pt, que nous placons au point de coordonnees (2.5, 2.5). 

/j\ Faites attention d vos unites 

Notre unite de mesure, dans fpdf_banque.php, est le mm. Ainsi, lorsque nous placons nos elements 
dans les fonctions Header() et FooterQ, c'est le millimetre qui est utilise. Si d'aventure, vous souhaitez 
travailler avec des pouces, n'oubliez pas de convertir les valeurs de ces deux fonctions. 

Nous utilisons ici, dans ce petit bout de classe, une nouvelle fonction : PageNoQ. Cette 
fonction renverra le numero de la page courante (si nous sommes sur la premiere page, 
elle renverra 1, si nous sommes sur la deuxieme, elle renverra 2, etc.). Cette fonction est 
a utiliser de concert avec la petite chaine de caracteres {nb}, qui renvoie toujours le 
nombre de pages du document. 

Avant de proceder a un test, il reste des modifications a effectuer dans le fichier 
fpdfjbanque.php. Nous allons effectivement changer les premieres lignes de ce 
programme : 

<?php 

/ / require ( ' f pelf / f pelf . php' ) ; 
include ' fpdf donnees . php' ; 
include 'fpdf classe. php'; 

//Creer une instance de FPDF 
//$pdf=new FPDF ( ) ; 
$pdf = new PDF ( ) ; 
$pdf->AliasNbPages () ; 



Le fichier fpdf. php n'est plus requis, puisque nous utilisons la classe PDF, contenue dans 
le fichier fpdf_classe.php, qu'il ne nous faut pas oublier d'inclure. Le constructeur aussi 
change : nous n'utilisons plus FPDF() mais PDF(). 

Juste apres le constructeur, nous appelons une nouvelle fonction : AliasNbPages(). Cette 
fonction n'a rien d'exceptionnel ou de remarquable. Simplement, si Ton veut utiliser la 
fonction PageNo() dans notre en-tete ou dans notre pied de page, il nous faut appeler cette 
fonction. Et pas n'importe ou : seulement entre l'appel du constructeur et l'ajout de la 
premiere page ! 
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fpdf banque.php (Objet applicalion/pdf) - Mozilla Firefox 



Fichier Edition Affichage 



jrique Marque- page 5 Outils 



http://localhost/DvnamiseE%2DPHP/chapQ4yfpdf_banque,php |G|- 



[H1H1QI I 



g Q g-i , ♦ □/> .ee f^l- ■ fel E3 |. 



Ins la rue 

n mensuelle 



Page 1/3 



ce electronique 
ar terre 



Fig. 4.1 1 : Le footer 

4.3 Importer une police de caracteres 

Utiliser seulement les quelques polices de caracteres parmi les plus classiques lors de la 
creation d'un document PDF est assez ennuyeux. Heureusement, FPDF nous permet 
d' avoir recours a des polices TrueType. Attention, la demarche est assez fastidieuse. 

Premiere etape : generer un fichier de metrique 

Bien evidemment, nous n'allons pas utiliser de police TrueType en trois lignes de code. 

Allez done chercher une petite archive zip contenant un utilitaire a l'adresse 
suivante : http://www.fpdf.org/fr/dl.php7id =33. 

Creez ensuite, a la racine de votre disque dur C :, un repertoire que vous nommerez 
ttf2ptl. Decompressez votre archive dans ce repertoire. Vous devriez avoir deux fichiers : 
ttf2ptl.exe et COPYRIGHT. Copiez ensuite, toujours dans le repertoire C:\ttf2ptl, un 
fichier de police TrueType. Dans notre exemple, nous allons utiliser le fichier comic.ttf. 

C'est maintenant que les barbarismes commencent. Ouvrez une nouvelle fenetre d'Invite 
de commandes (menu Demarrer puis Executer. Tapez ensuite cmd dans la fenetre qui 
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est apparue, puis cliquez sur OK). Naviguez jusqu'a rejoindre votre repertoire c:\ttf2ptl, 
puis entrez la commande suivante : 

ttf2ptl -a comic. ttf comic 

Ici, comic.ttf est le nom du fichier de police, et comic est le nom de la police auquel nous 
nous refererons lorsque nous souhaiterons l'utiliser au sein de FPDF. 



C:\WINDOWS\system32\cmd. 



Microsoft Windows XP [version 5.1.26001 
<C> Copyright 1985-2B01 Microsoft Corp. 

C:\Dociiments and SettingsSfldninistrateur 

C:\>cd ttF2ptl 

C:\ttf2ptl>ttf 2pti -a conic. ttf conic 



► Fig. 4.12: Pour generer un fichier de metrique.. . 

Regardez maintenant le contenu de votre repertoire C:\ttf2ptl : les fichiers comic.afm et 
comic.tla sont bel et bien presents. 



Deuxieme etape : generer le fichier de definition de police 

Regardez le contenu de votre repertoire chap04\fpdffont : ici, des fichiers PHP sont 
stockes. Chacun d'entre eux sert a definir une des polices que FPDF peut utiliser. Vous 
les reconnaissez d'ailleurs a leurs noms tres explicites : courier.php, helvetica.php... 
Notre but est maintenant de rajouter le fichier comic.php. 

Dans votre repertoire chap04, creez encore un nouveau repertoire que vous nommerez 
font. Copiez dans ce repertoire les fichiers comic. ttf et comic.afm (le fichier que nous 
venons de generer avec l'utilitaire ttflptl). Toujours dans ce meme repertoire, creez le 
fichier PHP fpdf_export _police.php et remplissez-le comme suit : 



^ fpdf_export_font.php 

<?php 

require ( ' . . / fpdf / f ont/makef ont/makef ont . php' ) ; 
MakeFont ( ' comic . ttf ' , ' comic . afm' , ' cpl2 52 ' ) ; 
?> 
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Nous utilisons ici la fonction MakeFont(), issue du fichier makefont.php (ce fichier fait 
partie de 1' archive FPDF que vous avez telechargee au debut de ce chapitre). 

Le premier parametre de cette fonction indique le fichier TrueType. II sera integre au 
fichier PDF. Si toutefois vous ne souhaitez pas l'integrer, car vous pensez que ce fichier 
TrueType est present sur la machine de l'utilisateur, ou que vous ne voulez pas augmenter 
le poids du fichier PDF que vous allez generer, ou pour toute autre raison, vous pouvez 
laisser une chaine vide. 

Le deuxieme parametre indique ou trouver le fichier .afin que nous avons genere 
ulterieurement. II est indispensable. 

Le troisieme parametre indique, par une chaine de caracteres, le type d'encodage a 
utiliser. II peut prendre les valeurs suivantes : 

cpl250 ' (Europe centrale) 
cpl251 1 (cyrillique) 
cpl252 1 (Europe de l'Ouest) 
' cpl253 ' (grec) 
' cpl254 ' (turc) 
1 cpl255 1 (hebreu) 
cpl257 1 (pays baltes) 
cpl258 ' (vietnamien) 
' cp874 ' (thai) 
1 ISO-8859-1 1 (Europe de l'Ouest) 
ISO-8859-2 1 (Europe centrale) 
ISO-8859-4 1 (pays baltes) 
ISO-8859-5 1 (cyrillique) 
ISO-8859-7 1 (grec) 
ISO-8859-9 1 (turc) 
ISO-8859-1 1' (thai) 
ISO-8859-15 1 (Europe de l'Ouest) 
ISO-8859-16 1 (Europe centrale) 
K0I8-R 1 (russe) 
K0I8-U 1 (ukrainien) 

II faut, bien entendu, que votre fichier de police dispose des caracteres correspondant a 
l'encodage choisi. Vous n'avez plus qu'a lancer le fichier fpdf_export_font.php dans votre 
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navigateur. Le fichier comic. php aura ete genere dans le meme repertoire que 
fpdf_exportJont.php. 



Si vous avez la compression ZLIB activee, le fichier comic. z sera aussi genere. II contient aussi votre 



Copiez les fichiers comic. php, comic. z (s'il a ete genere) et eventuellement (pour le ranger 
au meme endroit) le fichier comic.ttf dans votre repertoire chap04\fpdffont. Nous 
pouvons enfin utiliser la police Comic dans notre prochain document PDF. Voyons 
comment s'y prendre. Creez, dans votre repertoire chap04, le fichier fpdf_comic.php et 
remplissez-le comme suit : 

fpdf_comic.php 

<?php 

require ( ' f pdf / f pdf . php' ) ; 
$pdf=new FPDF ( ) ; 
$pdf->AddPage ( ) ; 

//Ecrire une chaine 
$pdf->AddFont ( ' Comic' , " ) ; 
$pdf->SetFont ('Comic' , 'U' ,16) ; 

$pdf->Cell (100, 0, utf 8_decode (' Une police importee !')); 

$pdf->Output ( ) ; 
?> 

Vous pouvez, si vous le souhaitez, lancer ce fichier depuis votre navigateur prefere. 



(J) Compresser sa police 



police, mais compressee. 



Troisieme et derniere etape : utiliser la police 




Fichier Edition Affichege Historiqije Marque-pages Outils ? 



Fig. 4.13 : 

La police importee 
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Voyons maintenant la derniere fonction de notre etude de FPDF : la fonction AddFont(). 

Cette fonction sert a importer dans notre document la police de caracteres dont nous 
avons besoin. Le deuxieme parametre n'est pas obligatoire, mais il definit le style de la 
police. 

Une police TrueType est en fait organisee en plusieurs fichiers : un fichier pour les 
caracteres normaux, un pour les caracteres en italique, un pour les gras et un pour les gras 
italiques. Nous n' avons, dans notre exemple, traite que le fichier contenant les caracteres 
normaux. C'est pour cela que nous mettons une chaine vide comme deuxieme argument. 
Si nous avions choisi de traiter aussi les caracteres gras, nous aurions appele une seconde 
fois la fonction AddFontQ, de cette maniere : 

$pdf->AddFont ('Comic' , 'B') ; 



4.4 Signer un document PDF 



Ouvrez votre fichier fpdf_comic.php dans votre navigateur, puis faites la combinaison de 
touches [Ctrl] +fp~], afm d'ouvrir la fenetre des proprietes du document. Vous remarquerez 
que tous les champs sont vides. 



Proprietes du document 



D ^ cr !R^ .! Protection Polices Avancees 



Fichier : fpdf_comic.php 



Auteur : J 
5ujet : [ 
Mots-cles : 



Datede creation : 04/12/2007 18:10:04 
Modifie le : 
Application : 



Description avancee 






Outil de conversion PDF : 


FPDF 1,53 




Version PDF : 


1.3(Acrobat4.x) 




Taille du fichier : 


89,42 Ko (91 562 octet?) 




Format de page : 


210 x 297 mm 


Nornbre de pages : 1 


PDF balise : 


Non 


Affichage Web rapide : Non 



Aide OK Annuler _j 



Fig. 4.14: Que de champs vides... 
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Nous allons y remedier. Ajoutez ce code a votre fichier fpdf_comic.php , juste avant 
l'appel a la fonction Output () : 

//proprietes du document 
$pdf->SetAuthor ( ' RedFish' ) ; 
$pdf->SetCreator (' Fait avec FPDF'); 
$pdf->SetKe ywords ( ' FPDF RedFish PHP'); 
$pdf->SetSubject (' Police Comic Font import'); 
$pdf->SetTitle (utf 8_decode ( ' La police comic . ttf ')) ; 

Les noms de ces fonctions sont explicites, ne trouvez-vous pas ? Elles ne prennent toutes 
qu'une seule chaine de caracteres comme argument. Vous pouvez relancer votre 
fpdf_comic.php depuis votre navigateur, et regarder les proprietes de votre document. 



Proprietes du document 



[■e-xtip.Nor, | F ,, : ,fe':N.;.r, I Fv.lKey. || A br..:eev. | 



Fichier : fpdfjiornic.php 
Titre : |La police comic. ttf 



Auteur : |RedFish 



Sujet : [Police Comic Font import 



Mots-des : FPDF RedFish PHP 



04/12/2007 18:18:37 



Fait avec FPDF 



Date de creation 
Modifie le 
Application 

Description avancee — 

Outil de conversion PDF : FPDF 1.53 

Version PDF : 1.3 (Acrobat 4 . x) 

Taille du fichier : 89,55 Ko (91 700 octets) 

Format de page : 210 x 297 mm 

PDF balise : Non 



Nombre de pages : 1 
Affichage Web rapide : Non 



OK [ Annuler ] 



Fig. 4.15: Les champs sont remplis ! 
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4.5 Check-list 

Nous avons termine l'etude de FPDF. Dans ce chapitre, nous avons vu comment : 

generer des documents PDF avec PHP, les enregistrer localement, les afficher sur le 
navigateur ou proposer aux utilisateurs de les telecharger ; 

>/ importer des images dans un document PDF ; 

ecrire du texte, des blocs de texte et creer des tableaux ; 

utiliser les fonctions de dessins de FPDF ; 
s/ creer des en-tetes et des pieds de page ; 
<y importer une police TrueType ; 
^ signer vos documents PDF 
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5.1 LDAP ? Qu'est-ce que c'est ? 

5.2 Installation 

5.3 Gerer LDAP avec PHP 

5.4 Cas pratique : gerer ses contacts 

5.5 Check-list 



Gerer vos 
annuaires 
avec LDAP 



Aujourd'hui, les bases de donnees sont utilisees d tout 
bout de champ et ce, meme lorsque d'autres solutions 
s'averent plus efficaces et plus rapides. Vous allez 
comprendre que LDAP s'adapte aussi tres bien lorsqu'il 
s'agit de gerer un ensemble d'etres humains (employes, 
contacts professionnels, etc.). 



Gerer vos annuaires avec LDAP 



5.1 LDAP ? Qu'est-ce que c'est ? 

LDAP est un acronyme pour Lightweight Directory Access Protocol. Comme vous 
pouvez le voir par son dernier mot (Protocol), LDAP est un protocole comme il en existe 
beaucoup en informatique : HTTP, TCP, IP, etc. 

En francais, on pourrait le traduire, plus ou moins litteralement, par "protocole d'acces a 
un repertoire de taille legere", le terme Lighweight etant aussi utilise en boxe pour 
designer une categorie de poids... tres leger bien sfir. 

Le mot Directory signifiant repertoire, LDAP obeit bien a la logique des fichiers et 
dossiers au niveau de l'arborescence. En fait, LDAP fonctionne comme un systeme 
d'arborescence de dossiers et fichiers mais pour des informations afm de creer un 
annuaire contenant une section (souvent appelee Monde), des sous-sections, des sous 
sous-sections, et ainsi de suite. 

Vous allez decouvrir, dans la partie qui suit, 1' installation sous Windows. En ce qui 
concerne 1' installation sous Linux, LDAP est souvent installe par defaut avec la 
distribution. Cependant, pour ceux qui ne l'ont pas, reportez-vous a l'aide de votre 
distribution de Linux. Les commandes different quelque peu et les versions aussi en 
fonction de la distribution de Linux que vous utilisez : Debian, Gentoo, RedHat, 
Mandrake, etc. Puis, afm de bien comprendre comment fonctionne LDAP, vous concevrez 
l'arborescence de 1' annuaire qu'il sera necessaire de mettre en place dans le cas pratique 
et vous verrez comment agir sur LDAP avec PHP. Pour fmir, vous mettrez en pratique 
l'arborescence concue pour creer un annuaire qui vous permettra de memoriser tous vos 
contacts professionnels et/ou personnels. LDAP etant tres simple a utiliser, le cas pratique 
se fera tout au long de la section Manipulations dans LDAP et vous aurez le code complet 
place en fin de chapitre comme pour les autres extensions etudiees precedemment. Seuls 
des formulaires HTML de saisie seront ajoutes dans les scripts du cas pratique 

5.2 Installation 

Windows 

Allez sur le site http://download.bergmans.us/openldap et cliquez avec le bouton gauche de la 
souris sur le repertoire openldap-x.x.xx. Au moment de l'ecriture de cet article, la derniere 
version etait 2.2.29. 

Une fois dans ce repertoire, vous devez telecharger le fichier openldap-2.2.29-db-4 
. 3. 29-openssl-0. 9. 8a-win32_Setup. exe . 
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llndex of /openldap/openldap-2.2.29 



Lastjnodified Size I>esaiphon 



Parent Directory 

|5 openldap-2.2.29-db-4.3.29-openssl-0.9.Sa-EDE QNLY-win32 Setup.ese 13-Jan-2006 07:11 1.5M 





b-4 ? 2!i-^pcii!ri-(.) 9 8a-wm32 Sctup.cxel 



> (Dsbian) Server at. dowMoad.hergma//is.us Port c 



Ouveituie de openldap-2.2.23-db-4.3.29-openssl-0.3.8a-win... [j 



Vous avez choisi d'ouviir 
H ...-2.2.29-db-4.3.29-openssl-u.9.Ba-win32_Setup.eite 
qui est un fichier de type : Application 
a partii de : http://download.beigmans.us 

Voulez-vous enregistier ce fichiei ? 



| Enregistrei le fichiei | Annuler 



Fig. 5.1 : Telechargerlefichier.exe 



2 Puis installez-le. Cela se fait en quelques etapes seulement. Commencez par choisir 
la langue. Le choix est restreint : anglais (English) ou allemand (Deutsch). 




Fig. 5.2 : 

Choisir la langue 



Fermez tous les programmes actifs, pensez surtout a desactiver 1' antivirus, et cliquez 
sur Suivant. 




zeds 



Welcome to the OpenLDAP Setup 
Wizard 

This will install openldap-2.2.29 on your computer 

': is recommended that you cicse all other applications before 
continuing. 

Click Ne;*:t to continue. 01 Cancel to eKii Setup. 



Fig. 5.3 : 

Depart de I'installation 
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4 Acceptez la licence et cliquez sur Suivant. 



iff Setup - OpenLDAP 



License Agreement 

Please read the following important information before continuing. 



Please read the following License Agreement. You must accept the terms of this 
agreement before continuing with the installation. 



The OpenLDAP Public License 
Version 2.8,1 7 August 2003 

Redistribution and use of this software and associated documentation 
("Software"), with or without modification!, are permitted provided 
that the following conditions are met: 

1. Redistributions in source form must retain copyright statements 
and notices, 

2. Redistributions in binary form must reproduce applicable copyright 

(* I accept the agreement 

C I do not accept the agreement 




Fig. 5.4 : 

Acceptez la licence 



5 Choisissez ensuite la destination d' installation, vous pouvez laisser le chemin par 
defaut. 



f Setup - OpenLDAP 



Select Destination Location 

Where should OpenLDAP be installed? 



EE 




f^Jf Setup will install OpenLDAP into the following folder. 

To continue, click Newt. If you would like to select a different folder, click Browse. 

Browse... | 



C:\Prograrn Files\OpenLDA 



At least 0,7 MB of free disk space is required. 



{Back | Next? | Cancel | 



► Fig. 5.5 : 

Destination d'installation 



6 Si vous desirez installer aussi slurpd, cochez la case correspondante. slurpd et slapd. 
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1 S etup - □ penLD AP 15 


|x| 


Select Components 

Which components should be installed? 




Select the components you want to install; clear the components you do not want to 
nstall. Click Next when you are ready to continue. 






Full installation ^ 






© install OpenLDAP openldap-2. 2. 29 107 MB 
El install BDB-tools 0,3 MB 






^Bnj install DpenLDAP-slapd as NT service 






l~l install DpenLDAP-slurpd as NT service 






Current selection requires at least 1 1 ,4 MB of disk space. 





Fig. 5.6 : 



(Back I Next> I Cancel I 



7 Si vous desirez un dossier dans le menu Demarrer, saisissez un nom ou laissez celui 
par defaut. Si vous ne voulez par qu'un dossier soit dans le menu Demarrer, cochez 
la case en bas a gauche. 



|g! Setup - OpenLDAP 



Select Start Menu Folder 

Where should Setup place the program's shortcuts? 



Setup will create the program's shortcuts in the following Start Menu folder. 
To continue, click Next. If you would like to select a different folder, click Browse. 




Fig. 5.7: 

Dossier dans menu 
Demarrer 



I - Don't create a Start Menu folder 



8 Pour l'etape suivante, il vaut mieux laisser la premiere option cochee. Cela permettra 
de demarrer le demon LDAP chaque fois que vous allumerez votre ordinateur. A 
vous de decider si vous desirez placer une icone sur le bureau ou non. Dans 
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1' affirmative, il est vivement conseille de cocher l'option. Cela vous permettra de 
demarrer slapd aussitot 1' installation sans avoir a redemarrer votre ordinateur. 



f Setup - OpenLDAP 



Select Additional Tasks 

Which additional tasks should be performed? 




Select the additional tasks you would like Setup to perform while installing OpenLDAP, 
then click Newt. 

W automatically start OpenLDAP NT service(s) after reboot 
Additional icons: 
V peate a desktop icon; 



| Newt > I Cancel | 



Fig. 5.8 : 

Demarrage d chaque 
boot de Windows 



Procedez a un dernier controle pour etre stir que toutes les bonnes informations ont 
ete selectionnees. Si tout est correct, cliquez sur Install. 



Setup - OpenLDAP 



Ready to Install 

Setup is now ready to begin installing OpenLDAP on your computer. 




Click Install to continue with the installation, or click Back if you want to review or 
change any settings. 



Destination location: 

C:\Program Files\OpenLDAP 






Setup type: 

Custom installation 






Selected components: 

install OpenLDAP openldap-2.2.2S 
install BDB-tools 

install OpenLDAP-slapd as NT service 
install OpenLDAP-slurpd as NT service 






Start Menu folder: 






J 







| i nstall | Lane el | 



Fig. 5.9 : 

Verifications avant 
installation 



lOTerminez 1' installation. 



IBS 



Installation 5 




Et voila, vous avez reussi 1' installation. 

Maintenant que Installation est terminee, il ne vous reste plus qu'a passer a la 
configuration. Editez le fichier slapd.conf. Si vous avez laisse la destination par defaut 
lors de 1' installation, ce fichier se situe dans C:\Program Files\OpenLDAF\. A la fin du 
fichier, vous pouvez prendre connaissance de la configuration par defaut. Vous pouvez 
laisser en l'etat pour les tests de ce chapitre. 



52 MMMMMMMMMMMMMMMMMMMMMMMMMMMMMM##m 

53 # EDE database definitions 

54 MMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMm 

55 

56 database bdb 

57 suffix "dc=domaine, dc=org" 

58 rootdn "cn= Manager , dc=domaine, dc=org" 

59 # Cleartext passwords, especially for the rootdn, should 

# be avoid. See slappasswd (8) and slapd. conf (5) for details. 

61 # Use of strong authentication encouraged. 

62 rootpw secret 

# The database directory MUST exist prior to running slapd AND 

64 # should only be accessible by the slapd and slap tools. 

65 # Mode 700 recommended. 

66 directory ./data 

67 # Indices to maintain 

68 index objectClass eq 

Fig. 5.11 : slapd.conf edite avec Notepad++ 
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Fermez le fichier et cliquez deux fois rapidement (double-clic) sur l'icone de votre 
bureau. Une fenetre MS-DOS s'ouvre. Cette fenetre doit rester ouverte autant de temps 
que vous utilisez LDAP. Par confort de travail, certains prennent 1' habitude de la reduire. 



c:v Prompt in OpenLDAP directory 






X 


Microsoft Windows XF [version 5.1 


2600] 






<C> Copyright 1985-2001 Microsoft 


Corp. 






C : SPr o gran Files SOpe n LDA P > 

























Fig. 5.12: Lancement de OpenLDAP 



Toujours dans le repertoire C:\Program Files\OpenLDAP , creez un fichier que vous allez 
nommer defaut. ini et saisissez les lignes suivantes : 



dn: dc=domaine, dc=org 


ob j ectclass : 


top 


ob j ectclass : 


dcOb j ect 


ob j ectclass : 


organization 


o: Domaine 




dc : domaine 





Puis ouvrez une fenetre MS-DOS en double-cliquant sur l'icone qui s'est placee sur votre 
Bureau lors de 1' installation. Une fenetre MS-DOS va s'ouvrir avec le prompt 
directement place dans C:\Program Files\OpenLDAP . Saisissez la commande si apadd -f 
slapd.conf -1 config.ini. Si tout s'est bien passe, rien ne s'est affiche a part le prompt 
dans la ligne en dessous. Fermez la fenetre MS-DOS puis allez dans le repertoire LDAP 
et double-cliquez sur l'icone slapd.exe. LDAP est maintenant demarre et est fonctionnel. 

II vous reste a present une autre procedure a effectuer concernant la partie PHP. Modifiez 
le fichier php.ini et dans la section Dynamic Extensions du fichier, enlevez le 
point-virgule ( ; ) a la ligne ;extension=php_ldap, enregistrez le changement, fermez le 
fichier php.ini et redemarrez le serveur web (Apache2). Vous allez maintenant verifier si 
tout s'est bien passe en vous connectant a LDAP via PHP. Creez un repertoire chap05 
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dans le repertoire dynamisez_php. Puis creez le fichier connexion_deconnexion.php dans 
le repertoire chap05 et inserez dans le fichier le code suivant : 

testerjdap.php 

<?php 

$ldc = ldap_connect ( ' localhost ' ) ; 
if (!$ldc) { 

echo 'Impossible de se connecter au serveur LDAP'; 
} else { 

echo 'Connexion au serveur LDAP effectuee avec succes'; 

} 

ldap_close ( $ldc) ; 
?> 

Executez le script dans votre navigateur et si tout s'est bien passe, le message "Connexion 
au serveur LDAP effectuee avec succes" se sera affiche. Si c'est votre cas, vous n'avez 
plus qu'a vous feliciter. Vous pouvez passer a la section : Interaction entre PHP et LDAP. 

Linux 

En ce qui concerne 1' installation sous Linux, voici quelques sites en fonction de votre 
distribution sur lesquels vous pourrez aller pour installer LDAP sur votre distribution 
Linux. 

Debian 

Pour cette installation, nous nous sommes bases sur la ressource trouvee a la page web 
de Coagul, www.coagul.org/article.php3?id_article=172. 

En principe, LDAP fait partie integrante de Linux. Cependant, des que Ton prend un peu 
d' assurance avec le systeme Linux, on a tres vite envie de se faire sa propre configuration 
en installant les packages en fonction de ses besoins. Nous partons done du principe que 
LDAP n'est pas encore installe. Nous allons vous expliquer etape par etape comment 
installer et configurer OpenLDAP sur une Debian. Pour cette installation, vous pouvez 
utiliser Etch (stable) sur un ordinateur portable premier prix. 

Ouvrez une console. II en existe plusieurs sous Linux : xterm, eterm, etc. Saisissez la 
commande su suivi du mot de passe de 1' administrateur Linux {root) demande. Vous 
savez que vous etes connecte en tant qu' administrateur root lorsque, juste avant le 
curseur, vous avez le signe diese (#) au lieu du signe dollar ($). 
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Listez les paquets concernes par OpenLDAP en saisissant la commande suivante : 
apt-cache search openldap: 

libldap2 — OpenLDAP libraries ; 

gforge-ldap-openldap — collaborative development tool — LDAP directory (using 
OpenLDAP) ; 

Idap-utils — OpenLDAP utilities ; 

Idapscripts — Add and remove user and groups (stored in a LDAP directory) ; 
libdbd-ldap-perl - Perl extension for LDAP access via an SQL/Perl DBI interface ; 
libldap-2.3-0 — OpenLDAP libraries ; 

libldap -ruby 1.8 — OpenLDAP library binding for Ruby 1.8 ; 
Ubldap2-dev — OpenLDAP development libraries ; 

libsasl2-modules-ldap — Pluggable Authentication Modules for SASL (LDAP) ; 
python-ldap — A LDAP interface module for Python ; 
slapd — OpenLDAP server (slapd) ; 

smbldap-tools — scripts to manage Unix and Samba accounts stored on LDAP. 

Tous ces paquets ne sont pas indispensables pour utiliser LDAP via PHP En fait, seuls 
le serveur et le client LDAP sont necessaires. Dans certaines documentations, la 
commande indiquee pour installer LDAP est : 

# apt-get install ldap-server ldap-client 

Or, sous Etch, cette commande affiche une note comme quoi ldap-server sera remplace 
par slapd et ldap-client sera remplace par ldap-utils. D'ailleurs, il est tres facile de 
remarquer que si apd et 1 dap-uti 1 s sont visibles dans la liste des paquets precedents alors 
que ldap-server et ldap-client ne le sont pas. 

Commencez 1' installation : 

# apt-get install slapd ldap-utils 
S Editez le fichier de configuration : 

# nano /etc/ldap/ slapd . conf 

3 Modifiez la ligne 57 du fichier : 

suffix "dc=mon annuaire , dc=org" 

Decommentez la ligne 6 1 et modifiez-la : 

rootdb " cn=Manager , dc=mon annuaire, dc=org" 
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5 Puis ajoutez a la ligne suivante : 

rootpw secret 

6 Pour finir, modifiez les lignes 96 a 100 : 

access to attrs=UserPassword, shadowLastChange 

by dn=" cn=Manager , dc=mon annuaire, dc=org" 
by anonymous auth 
by self write 
by * none 

7 Ainsi que les lignes 115 a 177 : 

access to * 

by dn="cn=Manager , dc=mon annuaire , dc=org" write 
by * read 

Et c'est fini. II ne reste plus qu'a redemarrer le serveur LDAP avec la commande 
suivante : 

# /etc/init . d/slapd restart 

Vous devez ensuite verifier que LDAP est reconnu par PHP Pour cela, executez le fichier 
PHP qui contient la fonction phpinfo(). Ensuite, assurez-vous que la connexion a LDAP 
fonctionne par le biais de PHP avec la configuration qui a ete modifiee. Executez dans un 
navigateur le script suivant : 

fl^ testerjdap.php 

<?php 

$ldc = ldap_connect ( ' localhost' ) ; 
if ( !$ldc) { 

echo 'Impossible de se connecter au serveur LDAP'; 
} else { 

echo 'Connexion au serveur LDAP effectuee avec succes' ; 

} 

ldap_close ( $ldc) ; 
?> 

Enfin... il y a eu bonne decouverte de LDAP avec PHP 
Gentoo 

Rendez-vous sur le site suivant : www.gentoo.org/doc/fr/ldap-howto.xml. 
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RedHat 

Rendez-vous sur www.redhat.com/docs/manuals/enterprise/RHEL-4-Manual/fr/ref-guide/index.litml et 

cliquez sur le lien "13 Protocole LDAP (Lightweight Directory Access Protocol)". 

Suse 

LDAP est installe par defaut avec Suse. 

5.3 Gerer LDAP avec PHP 

Se connecter/deconnecter 
Connexion 

Se connecter au serveur LDAP est aussi simple que de se connecter a un serveur MySQL. 
La fonction se nomme ldap_connect() et sa syntaxe est la suivante : 

ressource ldap_connect( [chaTne $nom_serveur [, entier $port]]); 

La fonction prend en premier parametre, optionnel, le nom du serveur LDAP 
($nom_serveur) et en second parametre, egalement optionnel, le numero de port ($port) 
sur lequel LDAP ecoute les requetes qui lui sont destinees. Le port par defaut en ce qui 
concerne LDAP est le port TCP 389. Le resultat retourne par LDAP est un identifiant de 
connexion en cas de succes et FALSE en cas d'echec. Le resultat de FALSE concerne la 
version 3 de LDAP uniquement. 

(D LDAP 2.X.X k 

Avec LDAP 2.X.X, ldap_connect() retournera toujours un identifiant, que la connexion reussisse ou non. 
En cas d'echec, il retournera une ressource en initialisant uniquement les identifiants de connexion. 

<?php 

$ldc = ldap_connect ( ' localhost' , 389) 

or die (' Impossible de se connecter au serveur LDAP'); 

/* instructions */ 
?> 
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(j) die() vs Exception 

Afin de faciliter la comprehension, et de raccourcir le code, nous avons utilise la fonction die(). 
Cependant, cette fonction est d eviter pour une question de securite. De plus, depuis la version 5 de 
PHP, les exceptions sont comprises par defaut dans le noyau de PHP et nous vous conseillons vivement 
de les utiliser dans vos projets. Si ce n'est pas le cas, etudiez les exceptions serieusement et integrez-les 
dans vos projets. 

La variable $ldc est l'identifiant de connexion (en anglais : link_identifier). 
Deconnexion 

La deconnexion est encore plus simple que la connexion et se passe totalement de 
commentaires : 

int 1 dap_cl ose(ressource $id_connexion) 

<?php 

/* instructions */ 

ldap_close ( $ldc) ; 
?> 



Manipulations dans LDAP 

Authentification au serveur LDAP : ldap_bind() 

bool ldap_bind(ressource $id_connexion 
[, chaTne $bind_rdn [, chaTne $bi nd_pass] ] ) 
Plutot que vous donner longue definition, voici du code : 

mauvaise_authentification.php 

<?php 

$ldc = ldap_connect ( ' localhost' ) or die (' Impossible de se connecter au 

serveur LDAP' ) ; 
echo $ldc . '<br/>'; 

// Authentification au serveur LDAP 

echo 'Authentification avec <code>ldap_bind ( ) </code> : ' ; 
$ldb = ldap_bind($ldc) ; 
echo $ldb; 
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ldap_close ($ldc) ; 
?> 



Utiliser le script tel quel va vous generer un message d'erreur Warning exprimant un 
probleme de protocole : 



Resource id #2 

Authentication avec ldap_bind() : 1 



► Fig. 5.13 : 

Warning a I'authentification 



Pourquoi ? Le serveur LDAP est en version de protocole 3 alors que PHP envoie ses 
ordres en version de protocole 2. II est done necessaire d'ajouter la ligne : 

ldap_set_option($ldc, LDAP_0PT_PR0T0C0L_VERSI0N, 3); avant la ligne $ldb = 
1 dap_bi nd ($1 dc) ; arm de permettre l'authentincation (anonyme) au serveur LDAP 



bonne_authentification.php 

<?php 

$ldc = ldap_connect ( ' localhost' ) 

or die (' Impossible de se connecter au serveur LDAP'); 
echo $ldc . '<br/>'; 

// Authentif ication au serveur LDAP 

echo ' Authentif ication avec <code>ldap_bind ( ) </code> : ' ; 

// Voici la ligne qui evite le message de Warning 
ldap_set_option ($ldc, LDAP_OPT_PROTOCOL_VERSION, 3); 

$ldb = ldap_bind($ldc) ; 
echo $ldb; 

ldap_close ($ldc) ; 
?> 

bool ldap_set_option(ressource $id_connexion, 

entier $option, mixte $nouvel le_valeur_option) ; 

$option correspond done a une option dont celle-ci possede deja une valeur, attribuee par 
defaut par PHP, que vous desirez modifier (la valeur). Le premier parametre, 
$id_connexion, est l'identifiant de connexion defini lors de l'appel de la fonction 
ldap_connect() et le troisieme, $nouvel 1 e_val eur_option, correspond a la nouvelle 
valeur que vous voulez affecter a l'option placee en deuxieme parametre. 
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Les options possibles sont des constantes predefmies dans l'extension LDAP de PHP : 

LDAP_OPT_DEREF (entier) determine comment les aliases sont considered durant la 
recherche. II doit avoir pour valeur une de celles qui suivent : LDAP_DEREF_NEVER, 
LDAP_DEREF_SEARCHING, LDAP_DEREF_FI NDI NG ou LDAP_DEREF_ALWAYS. 
LDAP_OPT_SIZELIMIT (entier) definit une limite dans le nombre de resultats retournes 
par une recherche (vous pouvez par exemple retourner les 100 premiers noms meme 
si la recherche en trouve un nombre superieur). La valeur a cette option demande 
de retourner tous les resultats sans limite. 

LDAP_OPT_TIMELIMIT (entier) impose une limite de temps maximal, en secondes, 
pour effectuer une recherche. La valeur indique qu'il n'y a aucune limite de temps 
imposee. 

LDAP_0PT_PR0T0C0L_VERSI0N (entier) indique le protocole de version LDAP utilise 
afin de communiquer avec le serveur LDAP primaire. 
LDAP_0PT_ERR0R_NUMBER (entier). 

LDAP_OPT_REFERRALS (booleen). La valeur de cette option doit etre definie par 
LDAP_0PT_0N ou LDAP_0PT_0FF. Cette option est a ON par defaut. 
LDAP_OPT_RESTART (booleen) determine si les operations d'entrees/sorties de LDAP 
sont automatiquement redemarrees ou non en cas d'echec. La valeur de cette option 
doit etre definie par LDAP_0PT_0N ou LDAP_0PT_0FF. Par defaut, cette option est a OFF. 
■ LDAP_0PT_H0ST_NAME (chaine). 

LDAP_OPT_ERROR_STRING (chaine) definit un message d'erreur a retourner lorsqu'une 
erreur se produit dans la session LDAP. 

LDAP_OPT_MATCHED_DN (chaine) fournit la valeur DN retournee avec la plus recente 
erreur produite dans la session LDAP. 

LDAP_0PT_SERVER_C0NTR0LS (tableau) fournit une liste par defaut de controles du 
serveur LDAP envoyee avec chaque requete a effectuer. 

LDAP_0PT_CLIENT_C0NTR0LS (tableau) fournit une liste par defaut des controles du 
client affectant la session LDAP. 

Ecriture dans LDAP 

Ajouter un pays 

Voici venu le moment d' effectuer des ajouts dans LDAP. II est necessaire de bien 
comprendre LDAP et son fonctionnement auparavant. LDAP fonctionne sous forme 
d'arborescence. II y a un repertoire racine, souvent appele Monde, puis des 
sous-repertoires. En fait, "Monde" correspond au domaine (dc=mon_annuai re,dc=org 
dans les exemples de ce chapitre). 
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/l\ Caracteres accentues 

LDAP ne prend pas en compte les caracteres accentues. Par exemple, si vous essayez d'ajouter une 
personne dont le prenom est Frederic, il faut inserer Frederic sinon vous obtiendrez un message d'erreur 
de type "ldap_add(j : Invalid Syntax..." 



Si vous avez lu le fonctionnement par hierarchie de LDAP, vous comprenez que le 
premier objet a ajouter dans l'annuaire LDAP est le pays. Regardez le fichier 
ajouter_un jpays.php : 

ajouter_pays.php 

<?php 

$dn = ' cn=Manager , dc=mon annuaire , dc=org' ; 
$passldap = 'secret'; 

$ldc = ldap_connect ( ' localhost ' ) 

or die (' Impossible de se connecter au serveur LDAP'); 

// Voici la ligne qui evite le message de Warning 
ldap_set_option ($ldc, LDAP_OPT_PROTOCOL_VERSION, 3); 

// Authentif ication au serveur LDAP avec ldap bind() 
// Authentif ication avec identifiant 
$ldb = ldap_bind ( $ldc, $dn, $passldap) 

or die (' Authentif ication au serveur LDAP echouee' ) ; 

// Ajouter pays : definition des informations 

$info['c'] = 'France'; 

$inf o [ ' ob j ectClass ' ] [0] = 'country'; 

$info [' objectClass' ] [1] = 'top'; 

$rdn = ' c=' . $info['c'] . ' , dc=mon annuaire, dc=org' ; 

// Ajouter les donnees dans l'annuaire 
$lda = ldap_add ($ldc, $rdn, $info) ; 
if ($lda) { 

echo 'ajout dans annuaire LDAP effectue avec succes' ; 
} else { 

echo 'ajout dans annuaire LDAP echoue' ; 

} 

ldap_close ($ldc) ; 
?> 

Analyse du code et explications 

Ligne 5: $dn = 1 cn=Manager,dc=mon_annuai re,dc=org 1 ; 
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dn signifie distinguished name que Ton pourrait traduire en francais par nom unique 

(litteralement : nom distingue) ; 

cn signifie commonName (nom commun) ; 

dc signifie domainComponent (composants domaine) et contient toutes les 
composantes du nom de domaine. Si vous avez un nom de domaine du style 
domaine.asso.fr, alors vous devrez avoir la ligne suivante : $dn = 'cn=Manager 
,dc=domaine,dc=asso,dc=fr' ;. 

Ligne 16: $ldb = ldap_bind($ldc, $dn, $passldap); 

Pour pouvoir ajouter des informations dans l'annuaire, l'utilisateur doit s'identifier 
au serveur LDAP. Une connexion anonyme, comme vue dans les exemples 
precedents, n'est done pas possible. C'est pour cette raison que la fonction 
ldap_bind() contient la ressource de connexion en premier parametre et egalement 
le domaine en deuxieme parametre et le mot de passe en troisieme parametre. 
La syntaxe de la fonction ldap_bind() est la suivante : bool 1 dap bi nd (resource 
link_id [, string rdn [, string pass]] ). Les deuxieme et troisieme parametres 
sont optionnels pour la lecture dans l'annuaire mais obligatoires pour pouvoir y 
inserer des donnees. En indiquant le premier parametre dans la fonction, 
l'authentification est dite anonyme. 

Ligne 20 : $i nfo [ 1 c '] = 'France 1 ; 

$i nf o [ ' c ' ] definit le pays, c signifie countryName (nom du pays). Si vous voulez 
respecter la norme RFC4519, vous devrez remplacer la valeur France par FR qui est 
le code A2 de la norme ISO-3 166-2 pour la France. 

Ligne 26: $1 da = ldap_add($ldc, $rdn, $info); 

1 dap_add () est la fonction qui permet d'ajouter du contenu dans le repertoire LDAP. 

LDAP est tellement riche qu'il est impossible d'en faire le tour en quelques pages. Si vous 
voulez plus de renseignements sur LDAP, nous vous conseillons de consulter les annexes ou 
vous trouverez de nombreuses references a des ouvrages et des sites sur Internet. 

Ajouter une organisation 

fl^j ajouter_organisation 



<?php 




/** 




* a j outer une org . php 
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*/ 

$dn = ' cn=Manager , dc=mon annuaire , dc=org' ; 
$passldap = 'secret'; 

$ldc = ldap_connect (' localhost' ) 

or die (' Impossible de se connecter au serveur LDAP'); 

// Voici la ligne qui evite le message de Warning 
ldap_set_option ($ldc, LDAP_OPT_PROTOCOL_VERSION, 3); 

// Authentif ication au serveur LDAP avec ldap bind() 
// Authentif ication avec identifiant 
$ldb = ldap_bind($ldc, $dn, $passldap) 

or die (' Authentif ication au serveur LDAP echouee' ) ; 

// Ajouter une organisation : definition des informations 

$info['o'] = 'nom organisation'; 

$inf o [ ' ob j ectClass ' ] [0] = 'organization'; 

$info [' objectClass' ] [1] = 'top'; 

$rdn = ' o=' . $info['o'] . ' , c=France, dc=mon annuaire, dc=org' ; 

// Ajouter les donnees dans 1' annuaire 
$r = ldap_add ($ldc, $rdn, $info) ; 
if ($r) { 

echo 'donnees ajoutees : '. $rdn .'<br/>'; 
} else { 

echo 'ajout dans annuaire LDAP echoue<br/>' ; 

} 

ldap_close ($ldc) ; 
?> 

Comme vous pouvez le remarquer, les changements par rapport a l'ajout d'un pays sont 
minimes. La fonction 1 dap_add () fonctiorrne de la meme maniere pour l'ajout d'une 
organisation que pour l'ajout d'un pays. Elle fonctionnera d'ailleurs de la meme maniere 
pour l'ajout d'une unite et egalement pour l'ajout d'un individu (contact). 

Ajouter une unite 

ajouter_unite.php 

<?php 

* a j outer_une_unite . php 
*/ 

$dn = ' cn=Manager , dc=mon annuaire , dc=org' ; 
$passldap = ' secret' ; 
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$ldc = ldap_connect ( ' localhost' ) 

or die (' Impossible de se connecter au serveur LDAP'); 

// Voici la ligne qui evite le message de Warning 
ldap_set_option ($ldc, LDAP_OPT_PROTOCOL_VERSION, 3); 

// Authentif ication au serveur LDAP avec ldap bind() 
// Authentif ication avec identifiant 
$ldb = ldap_bind ( $ldc, $dn, $passldap) 

or die (' Authentif ication au serveur LDAP echouee' ) ; 

// Ajouter une organisation : definition des informations 

$info['ou'] = 'contacts personnels'; 

$inf o [ ' ob j ectClass ' ] [0] = ' organizationalUnit' ; 

$info [' objectClass' ] [1] = 'top'; 

$rdn = ' ou=' . $info['ou'] 

. ' , o=drapeau suire, c=France, dc=mon annuaire, dc=org' ; 

// Ajouter les donnees dans 1' annuaire 
$r = ldap_add ($ldc, $rdn, $info) ; 
if ($r) { 

echo 'donnees ajoutees : '. $rdn .'<br/>'; 
} else { 

echo 'ajout dans annuaire LDAP echoue<br/>' ; 

} 

ldap_close ( $ldc) ; 
?> 

Tout comme pour l'ajout d'un pays ou d'une unite, la logique de fonctionnement de 
LDAP reste la meme. Voila un element supplementaire qui fait tout l'interet de LDAP : 
sa simplicite d' utilisation. II est bien plus complique de concevoir l'arbre (arborescence) 
LDAP en lui-meme (en fonction de la complexite de la structure a mettre en place) que 
de le programmer par la suite pour le rendre operationnel. 

Ajouter un individu 

Tout comme pour les bases de donnees, il est indispensable, dans un annuaire LDAP, de 
definir un nom unique (une cle) pour chaque entree. Par exemple, il peut y avoir plusieurs 
David DRAPEAU (sn) mais un seul ddrapeau (cn) 

ajouterjndividu.php 

<?php 

$dn = ' cn=Manager , dc=mon annuaire, dc=org' ; 
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$passldap = 'secret'; 

$ldc = ldap_connect ( ' localhost ' ) 

or die (' Impossible de se connecter au serveur LDAP'); 

// Voici la ligne qui evite le message de Warning 
ldap_set_option ($ldc, LDAP_OPT_PROTOCOL_VERSION, 3); 

// Authentif ication au serveur LDAP avec ldap bind() 
// Authentif ication avec identifiant 
$ldb = ldap_bind ( $ldc, $dn, $passldap) 

or die (' Authentif ication au serveur LDAP echouee' ) ; 

// Ajouter une organisation : definition des informations 

$info ["cn"] = "ddrapeau"; 

$info ["sn"] = "David DRAPEAU"; 

$info [ "userPassword" ] = "unmotdepasse" ; 

$info ["objectClass"] [0] = "person"; 

$info [' objectClass' ] [1] = 'top'; 

$rdn = ' cn=' . $info['cn'] . ' , ou=nom unite 01, 

o=nom organisation 1 , c=France, dc=mon annuaire , dc=org' ; 

// Ajouter les donnees dans 1' annuaire 
$r = ldap_add ($ldc, $rdn, $info) ; 
if ($r) { 

echo 'donnees ajoutees : '. $rdn .'<br/>'; 
} else { 

echo 'ajout dans annuaire LDAP echoue<br/>' ; 

} 

ldap_close ($ldc) ; 
?> 

Afin de rester tres clair et concis, des elements comme l'adresse e-mail (liste de diffusion 
par exemple) ou le numero de securite sociale (employes d'une societe par exemple) 
n'ont pas ete pris en compte. Ajouter ces elements ne complique en rien la 
programmation LDAP avec PHP. 

Recherche/Lecture 

ldap_get_entries() 

Evidemment, une autre fonctionnalite primordiale d'un annuaire est de pouvoir acceder 
de nouveau a ses contacts. La fonction ldap_get_entries() est indispensable ami de 
stacker les donnees dans un tableau multidimensionnel. 

array ldap_get_entries(ressource $id_connexion, ressource $id_resul tat) 
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Le second parametre $i d_resul tat represente la valeur de retour de la fonction 
ldap_search(). 

ldap_search() 

Puis, il suffit d'utiliser 1 dap_search () associee a ldap_get_entries(). 

resource ldap_search(ressource $id_connexion, 

chaTne $base_dn, chaTne $filtre[, tableau $attributs 

[, entier $attrs_seuls [, entier $ tai 1 le_max[, entier $timel imi t 

[, entier $deref]]]]]) 

Comme vous pouvez vous en apercevoir, la fonction ldap_search() possede beaucoup de 
parametres. En voici la description : 

$id_connexion est l'identifiant de connexion defini par ldap_connect 
$base_dn est le DN (nom distingue) de base du dossier 
$filtre est le motif de recherche a effectuer ; 

$attributs permet de filtrer au niveau du retour de resultat. C'est-a-dire qu'il ne 
peut retourner que le sn par exemple. Quel que soit votre choix, le DN sera toujours 
retourne ; 

$attrs_seuls est par defaut a la valeur 0. Cela signifie qu'il retourne pour chaque 
attribut son type et sa valeur. Mettre $attrs_seul s a la valeur 1 signifie que seuls les 
types d'attributs seront retournes, sans les valeurs ; 
$ tai 1 1 ejnax represente le nombre de resultats maximal a retourner ; 
$temps_max specifie le temps maximal, en secondes, de duree de la recherche ; 
$deref precise comment les alias doivent etre geres durant la recherche. 

Ce qui donne pour lire les informations inserees grace aux scripts precedents, le script 
lecture _ldap.php : 

lecturejdap.php 

<?php 

echo "<h3>Lecture dans LDAP</h3>"; 
$ldc = ldap_connect ( ' localhost' ) 

or die (' impossible de se connecter au serveur LDAP'); 

ldap_set_option ($ldc, LDAP_OPT_PROTOCOL_VERSION, 3); 

ldap_bind ($ldc) 

or die ( ' authentif ication echouee' ) ; 



137 



Gerer vos annuaires avec LDAP 



// Liste de toutes les personnes 

$lds = ldap search($ldc, "dc=mon annuaire , dc=org" , "sn=*"); 
$ldge = ldap_get_entries ($ldc, $lds); 
echo "Lecture de 1' annuaire<br/>" ; 

for ($n=0; $n < $ldge ["count"]; $n++) { 
echo "dn : ". $ldge [ $n] [ "dn" ] ."<br/>"; 
echo "cn : ". $ldge [ $n] [ "cn" ] [ ] ."<br/>"; 
echo "sn : ". $ldge [ $n] [ " sn" ] [ ] ; 

} 

ldap_close ($ldc) ; 
?> 

Modifier une entree 

Un contact ne reste jamais immobile. II change de numero de telephone plusieurs fois 
dans sa vie. II demenage et il change done egalement d'adresse, de code postal et de 
commune, etc. II est done indispensable de pouvoir modifier des entrees de 1' annuaire. 
Pour effectuer toutes ces modifications, une seule fonction est necessaire : 

bool 1 dapjnodi fy(ressource $id_connexion, chaTne $dn, tableau $entrees) 
Supprimer une entree 

Lorsqu'un compte ne sert plus a rien (depart en retraite d'un employe), supprimer ledit 
compte est la moindre des actions a effectuer afin de garder un repertoire propre et a jour. 
La fonction 1 dap_del ete() permet de supprimer une entree dans un repertoire LDAP : 

bool 1 dap_del ete(ressource $id_connexion, chaTne $dn) 

Observez le script supprimer_contact.php qui effectue la suppression du compte 
ddrape02 : 



** 


supprimerjndividu.php 




<?php 






echo 


"<h3>Suppression du compte ddrape02</h3>" ; 




$ldc 


= ldap connect (' localhost ' ) 




or 


die (' impossible de se connecter au serveur 


LDAP' ) ; 


ldap 


set option ($ldc, LDAP OPT PROTOCOL VERSION, 


3) ; 


$dn = 


"cn=Manager , dc=mon annuaire , dc=org" ; 




ldap 


bind($ldc, $dn, "secret") 




or 


die ( ' authentif ication echouee' ) ; 
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// Ajouter une organisation : definition des informations 
$info ["en"] = "ddrape02"; 

$rdn = ' cn=' . $info['cn'] . ' , ou=contacts prof essionnels, o=drapeau 
suire , c=France , dc=mon annuaire, dc=org' ; 

// Liste de toutes les personnes 
if($ldd = ldap_delete ($ldc, $rdn) ) { 

echo 'suppression effectuee avec succes' ; 
} else { 

echo 'echec lors de la tentative de suppression'; 

} 

ldap_close ($ldc) ; 
?> 



Aller plus loin avec LDAP 
Gestion des erreurs 

Comme beaucoup d' extensions PHP, LDAP fournit deux fonctions pour recuperer les 
erreurs: 1 dap_errno() et ldap_error(). Vous apprendrez egalement a utiliser une 
troisieme fonction qui est ldap_err2str(). 

entier 1 dap_errno(ressource $id_connexion) retourne le numero d'erreur courant. 
chaTne 1 dap_error(ressource $id_connexion) retourne le message d'erreur sous 
forme de caracteres. 

chaTne ldap_err2str (entier $errno) retourne le message d'erreur grace au numero 
d'erreur ($errno). 

Le script gestion _erreursj.dap.php sera beaucoup plus parlant : 
gestion_erreurs_ldap.php 

<?php 

$ldc = ldap connect (' mauvais serveur' ) ; 
$ldb = ldap_bind($ldc) ; 
if ( !$ldb) { 

$numero erreur = ldap errno ( $ldc) ; 

$message erreur = ldap error ($ ldc ) ; 

$message_erreur de errno = ldap err2str ($numero erreur); 
echo 'numero erreur = ' . $numero erreur .'<br/>'; 
echo 'message erreur = '. $message erreur .'<br/>'; 
echo 'message de errno = ' . $message erreur de errno; 
} else { 
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echo 'connexion au serveur LDAP effectuee avec succes' ; 

} 

ldap_close ($ldc) ; 
?> 

Liberer la memoire 

Avec PHP, la memoire est automatiquement liberee a la fin du script. Aussi, il est tout de 
meme utile, a chaque fois que possible, de laisser un maximum d'espace memoire libre 
a tout instant. La fonction 1 dap_f ree_resul t () effectue la meme action que 
mysql_free_resul t() pour les BDD MySQL. C'est-a-dire qu'elle libere la memoire une 
fois l'operation effectuee. Voici un exemple de l'utilisation de 1 dap_f ree_resul t () avec 
le script gestion_memoire.php : 

m bool ldap_free_resul t(ressource $id_resul tat) 

$id_resul tat est la variable $ressource a laquelle est affectee la manipulation LDAP. Le 
script gestion_memoire.php en donne un exemple : 

Off, gestion_memoire.php 

<?php 

/* instructions LDAP */ 

$identif iant_resultat = ldap_delete ($ldc, $dn) ; 

// Liberation de l'espace memoire allouee 

// a 1' execution de la fonction ldap_delete ( ) 

mysql_free result ( $identifiant resultat) ; 

/* Autres instructions LDAP */ 

/* Autres instructions */ 
?> 

Les premiers... et les suivants 

first _attribute( ) 

chaine ldap_first_attribute(ressource $id_connexion, resource $result_entry 
_identifier, int &$ber_identif ier) 

Permet de recuperer le premier attribut d'une entree. Tous les autres attributs peuvent etre 
recuperes grace aux fonctions 1 dap_next_attri bute() et ldap_get_attribute(). 
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first _entry() 

ressource ldap_first_entry(ressource $id_connexion, ressource $result) 

Permet de recuperer la premiere entree d'un annuaire LDAP. Toutes les autres entrees 
peuvent etre recuperees grace aux fonctions 1 dap_next_entry() et ldap_get_entries(). 

first _reference() 

ressource ldap_first_reference (ressource $id_connexion, ressource $result) 

Permet de recuperer la premiere reference d'un annuaire LDAP Toutes les autres 
references peuvent etre recuperees grace aux fonctions ldap_next_reference() et 
ldap_get_reference(). 

5.4 Cas pratique : gerer ses contacts 

Bien entendu, les exemples cites precedemment ne sont pas anodins. lis vous ont permis 
de preparer le cas pratique. Maintenant que l'arbre LDAP est fonctionnel, il ne reste plus 
qu'a creer les formulaires qui permettent, entre autres, d'ajouter/modifier/supprimer un 
contact. Vous remarquerez que lors du script d'insertion d'un individu, un identifiant et 
un mot de passe ont ete crees pour l'individu afin que le cas pratique de ce chapitre puisse 
s'adapter au plus grand nombre de situations possibles. C'est-a-dire que si vous desirez 
simplement creer un annuaire de contacts, vous pouvez eviter la creation d'un mot de 
passe pour chaque utilisateur (individu). Mais s'il s'agit d'un annuaire de contacts pour 
un site Internet (ou toute autre application), et que chaque contact doit pouvoir se 
connecter a un back-office, alors ce cas pratique sera egalement fonctionnel. 

Le script ajouter_un_contact.php presente un formulaire qui vous permet d'ajouter un 
nouvel individu. II est simple et reprend en grande partie le script ajouterjndividu.php 
etudie precedemment : 

ajouter_entree.php 



<html> 




<head> 




<title>Aj outer 


un contact</title> 


</head> 




<body> 




<hl>Aj outer un 


contact dans 1 ' annuaire</hl> 


<?php 
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if (isset ($_POST [' submit' ] ) && $_POST [ ' nom' ] != "){ 
$dn = ' cn=Manager , dc=mon annuaire, dc=org' ; 
$passldap = ' secret' ; 

$ldc = ldap_connect ( ' localhost' ) 

or die (' Impossible de se connecter au serveur LDAP'); 

/ / Voici la ligne qui evite le message de Warning 
ldap_set_option ($ldc, LDAP_OPT_PROTOCOL_VERSION, 3) ; 

// Authentif ication au serveur LDAP avec ldap bind() 
// Authentif ication avec identifiant 
$ldb = ldap_bind ( $ldc, $dn, $passldap) 

or die ( 'Authentif ication au serveur LDAP echouee' ) ; 
// Aj outer une organisation : definition des informations 
$info ["cn"] = $_POST [' identifiant' ] ; 
$prenom = ucfirst($ POST [' prenom' ]) ; 
$nom = strtoupper ($_POST [' nom' ] ) ; 

$info["sn"] = $_POST [' prenom' ] .' '. $_POST [ ' nom' ] ; 
$inf o [ "userPassword" ] = $ POST ['mot de passe']; 
$info ["objectClass"] [0] = "person"; 
$info [' objectClass' ] [1] = 'top'; 

$rdn = ' cn=' . $info['cn'] . ' , ou=contacts_prof essionnels, o=drapeau 
suire, c=France, dc=mon annuaire , dc=org' ; 

// Aj outer les donnees dans 1' annuaire 
$r = ldap_add ($ldc, $rdn, $info) ; 
if ($r) { 

echo 'donnees ajoutees : '. $rdn .'<br/>'; 
} else { 

echo 'ajout : ' . $rdn .'<br/>dans annuaire LDAP echoue<br/>' ; 

} 

ldap_close ($ldc) ; 

} 

?> 

Informations du contact<br/> 
<form action="#" method="POST"> 

Identifiant <input type="text" name="identif iant" /> 

Mot de passe <input type="password" name="mot de_passe" /><br/> 

Nom <input type="text" name="nom" /> 

Prenom <input type="text" name="prenom" /><br/> 



SOS 



Cas pratique : gerer ses contacts 



s 



<input type="submit" name=" submit" value="Valider " /><br/> 
</form> 

</body> 
</html> 

Le script ajouter_un_contact.php presente un formulaire qui contient des champs de texte 
pour que vous puissiez saisir les informations du contact et un bouton Valider arm de les 
inserer dans LDAP. Gardez en memoire, qu'avec LDAP, vous ne pouvez pas saisir de 
caracteres accentues. Cela signifie que le prenom Stephane devra etre saisi "Stephane" 
(sans les guillemets, cela va de soi). 

L'interet de creer un annuaire de contact est de pouvoir retrouver un contact tres 
rapidement grace a une recherche ciblee par un utilisateur. Le script lister_contacts.php 
montre un exemple de recherche d'un ou plusieurs contacts sur le sn : 

J^jt lister_entrees.php 

<html> 
<head> 

<title>Af f icher la liste</title> 

</head> 

<body> 

<form action="#" method="POST"> 

Rechercher <input type="text" name="rechercher" size="30" /> 

<br/> 

<input type="submit" name=" submit" value="Lancer la recherche" /> 
</ f orm> 

<br/> 
<?php 

if (isset ($_POST [' submit' ] ) && $_POST [' rechercher ' ] != "){ 

$rechercher = trim (htmlspecialchars (strip tags ($ POST [' rechercher ']) , 

ENT_QUOTES) ) ; 
echo "<h3>Resultat de la recherche</h3>" ; 
$ldc = ldap_connect ( ' localhost ' ) 

or die (' impossible de se connecter au serveur LDAP' ) ; 

ldap_set_option ($ldc, LDAP_OPT_PROTOCOL_VERSION, 3); 

ldap_bind($ldc) 

or die ( ' authentif ication echouee' ) ; 



// Liste de toutes les personnes 
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$lds = ldap search ($ldc, "dc=mon annuaire , dc=org" , " sn=$rechercher* " ) ; 
$ldge = ldap_get_entries ($ldc, $lds); 
echo "Lecture de 1' annuaire<br />" ; 

for ($n=0; $n < $ldge ["count"]; $n++) { 
echo "dn : ". $ldge [ $n] [ "dn" ] ."<br/>"; 
echo "cn : ". $ldge [ $n] [ " cn" ] [ ] ."<br/>"; 
echo "sn : ". $ldge [ $n] [ " sn" ] [ ] ; 

} 

ldap_close ($ldc) ; 

} 

?> 

</body> 
</html> 

Bien entendu, il peut etre necessaire de supprimer un contact. Par exemple, un employe 
quitte l'entreprise pour une quelconque raison (fin de contrat, demission, licenciement, 
etc.), et il est done bien utile de pouvoir supprimer son compte arm de ne pas laisser dans 
1' annuaire LDAP des comptes inactifs. Regardez le script supprimer _entree.php qui 
effectue cette operation a merveille : 



supprimer_entree.php 




<html> 




<head> 




<title>Supprimer une entree</title> 




</head> 




<body> 




<form action="#" method="POST"> 




Rechercher <input type="text" name=" supprimer" size="30" /> 




<br/> 




<input type=" submit" name="submit" value="Lancer la recherche" /> 




</form> 




<br/> 




<?php 




if(isset($ POST [' submit' ] ) && $ POST [' supprimer ' ] != "){ 




$supprimer = trim (htmlspecialchars ( strip tags($ POST [' supprimer' ] 


) , 


ENT QUOTES) ) ; 




echo "<h3>Supprimer une entree</h3>" ; 




$ldc = ldap connect (' localhost' ) 




or die (' impossible de se connecter au serveur LDAP' ) ; 
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ldap_set_option ($ldc, LDAP_OPT_PROTOCOL_VERSION, 3); 
$dn = "cn=Manager , dc=mon annuaire , dc=org" ; 
ldap_bind ($ldc, $dn, "secret") 

or die ( ' authentif ication echouee' ) ; 

// Ajouter une organisation : definition des informations 
$rdn = ' cn=' . $supprimer . ' , ou=contacts professionnels, o=drapeau 
suire, c=France , dc=mon annuaire, dc=org' ; 

// Liste de toutes les personnes 
if($ldd = ldap_delete ($ldc, $rdn) ) { 

echo 'suppression effectuee avec succes' ; 
} else { 

echo 'echec lors de la tentative de suppression'; 

} 

ldap_close ($ldc) ; 

} 

?> 

</body> 
</html> 

Vous voila maintenant equipe d'une application sommaire pour gerer vos contacts, 
employes et autres personnes grace a un annuaire LDAP. Comme pour tous les autres 
chapitres, arm de satisfaire au plus grand nombre, les cas pratiques sont volontairement 
basiques et tres ouverts a toutes evolutions ulterieures en fonction de vos besoins. Tres 
utiles dans cet exemple pour des authentifications, vous pouvez toujours ajouter des 
informations supplementaires pour chaque individu comme par exemple une adresse 
e-mail ou encore un numero de telephone. Nous vous souhaitons ainsi de faire de belles 
decouvertes dans le monde de PHP/LDAP. Vous pouvez passer maintenant a un chapitre 
tout autant utile et interessant qui est l'abstraction d'acces aux bases de donnees. 

5.5 Check-list 

Au cours de ce chapitre, vous avez pu approcher les techniques de gestion d' annuaire 
avec LDAP Nous avons vu notamment : 

l'installation d'OpenLDAP sous Windows et Linux Debian ; 

la conception d'une arborescence LDAP ; 

la creation de 1' arborescence LDAP par le biais de PHP ; 
>/ l'ajout, la modification et la suppression d'une entree dans 1' annuaire LDAP ; 
<y des fonctions complementaires comme la gestion des erreurs, ou la memoire. 
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donnees avec 
PDO 

PDO [PHP Data Object) est une bibliotheque 
programmee en C pour PHP. Son avantage par 
rapport d d'autres bibliotheques de bases de donnees 
telles que PEAR::DB ou AdoDB, qui sont les plus connues, 
est que PDO est beaucoup plus rapide par rapport aux 
deux autres qui sont programmees en PHP et non en C 
comme Test PDO. 




6 Gerer les donnees avec PDO 



6.1 Installation 



Windows 

Installer PDO sous Windows est tres simple. Editez le nchier php.ini et decommentez la 
ligne ;extension=php_pdo.dl 1 en enlevant le point-virgule ( ; ) en debut de ligne. Faites 
de meme pour les extensions des pilotes des SGBD (Systeme de gestion de bases de 
donnees) que vous desirez utiliser : extension=php_pdo_*.dl 1 ou * est le nom du pilote 
du SGBD (par exemple extension=pdo_php_mysql .dll). Redemarrez le serveur web. 

Linux 

L'exemple cite ici est pour Debian Etch. Les autres versions ne doivent guere etre 
beaucoup plus differentes. 

Par le gestionnaire de paquets apt-get 

Avec les sources 

Telechargement 

Allez sur le site ftp://ftp.fr.postgresql.org/latest et telechargez la version adequate. Lors de la 
redaction de ce chapitre, la derniere version {latest) etait postgresql-8.2.5 '.tar.gz. Ensuite, 
placez-vous en root pour la suite des manipulations. 

Verification de 1' archive telechargee 

Pour cet exemple, les sources ont ete telechargees dans le repertoire /usr/local/src. 

# cd /usr/local/src 

Verification du checksum 

# md5sum postgresql-8 . 2 . 5 . tar . gz 

Si le checksum est OK, alors l'installation peut se poursuivre. 
Decompression du fichier 

# tar -xzvf postgresql-8 . 2 . 5 . tar . gz && cd postgresql-8.2.5 
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Configuration 

# ./configure --pref ix=/usr/local/pgsql 

Compilation 

# make && make install 

Demarrage 

# cd /usr/local/pgsql 

# adduser postgres 
Suivre les indications 

# mkdir /usr /local/pgsql/data 

# chown postgres /usr/local/pgsql/data 

# su - postgres 

postgres@domus : ~$ /usr/local/pgsql/bin/inidb -D /usr/local/pgsql/data 
success 

II y a deux methodes pour demarrer le serveur PostgresSQL. Soit en avant-plan avec la 
commande suivante : 

postgres@domus : ~$ /usr/local/pgsql/bin/postgres -D \ 
/usr/local/pgsql/data 

Soit en arriere-plan avec la commande suivante : 

postgres@domus : ~$ nohup /usr/local/pgsql/bin/postgres -D \ 

/usr/local/pgsql/data </dev/null »server.log 2>&1 </dev/null 

Pour arreter le serveur en arriere-plan, il suffit d'executer la commande : 

postgres@domus : ~$ kill 'cat /usr /local/pgsql/data/postmaster . pid' 

Et il ne reste plus qu'a activer PDO dans PHP Les tests ont ete effectues sur Debian Etch 
avec PHP6 que vous pouvez telecharger (les sources) sur http://snaps.php.net/. A l'heure oil 
ces lignes sont redigees, la version PHP6 n'est pas encore sortie officiellement. II est 
necessaire que PHP soit compile avec les options — wi th-pgsql =/DIR et 
— wi th-pdo-pgsql =/DIR. 
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Verifier 1' installation 

Executez votre script favori, phpinfo.php, qui contient la fonction phpinfo(). Et voici le 
resultat : 



pdo_pgsql 



PDO Driver for PostgreSQL 


enabled 


PostgreSQL(lil>pq) Version 


8.2.3 


Module version 


1.0.2 


Revision 


$ld:pdo_pgsql.c,v1.7.2.11.2.1 2007/01/01 09:36:05 Sebastian Exp $ 



pgsql 



PostgreSQL Support 


enabled 


PostgreSGLflihpq} Version 


8.2.3 


Multihyte character support 


enabled 


SSL support 


disabled 


Active Persistent Links 





Active Links 







Directive 


Local Value 


Master Value 


pgsql.allow_persistent 


On 


On 


pgsql.auto_reset_persistent 


Off 


Off 


pgsql.ignorejiotice 


Off 


Off 


pgsql.logjiotice 


Off 


Off 


pgsql.maxjinks 


Unlimited 


Unlimited 


pgsql.max_persisterrt 


Unlimited 


Unlimited 



Fig. 6.1 : PostgreSQL reconnu par PHP 



6.2 UtiliserPDO 

L'interet d'utiliser PDO reside dans le fait qu'avec PDO, quel que soit le SGBD que 
vous utilisez, les fonctions sont toujours les memes. Vous pouvez entierement vous 
concentrer sur les requetes SQL. De plus, en utilisant au maximum les normes SQL2 
ou SQL3, vous supprimerez (presque) toute dependance au SGBD utilise et cela 
facilitera une migration vers un autre SGBD si cela s'avere necessaire un jour. Les 
SGBD ayant tous leurs forces et leurs faiblesses, avec PDO vous pouvez vous 
connecter a plusieurs SGBD differents ann de consacrer chaque partie d'une application 
au SGBD qui lui soit le plus competent. 
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Se connecter/deconnecter 
Connexion 

Se connecter a PDO peut paraitre complexe, voire un peu deroutant pour quelqu'un ay ant 
utilise MySQL durant des annees avec les fonctions natives (mysql_*()). En fait, il s'agit 
juste d'un petit (vraiment petit) temps d'adaptation et de comprendre ce qu'est le DSN 
(Data Source Name). 

La connexion se fait toujours de la meme maniere quel que soit le SGBD auquel vous 
desirez acceder. Seuls les parametres passes dans le constructeur varient. Pour tous les 
SGBD, le premier parametre contient les DSN et des informations complementaires. 

Connexion MySQL 



connexion_mysql.php 

<?php 

$host = 'localhost'; 
$user = ' root' ; 
$pass = ' xxxxxxx' ; 
$db = ' test' ; 

$oPDOLink = new pdo ( "mysql : host=$host; dbname=$db" , $user, $pass) ; 
if ( ! $oPDOLink) { 

echo 'Connexion au serveur MySQL impossible'; 
} else { 

echo 'Connexion au serveur MySQL effectuee avec succes' ; 

} 

$oPDOLink = NULL; 
?> 



Connexion PostgreSQL 

connexion_pgsql.php 

<?php 



$host = 
$user = 
$pass = 



' localhost' ; 
' postgres ' ; 
' xxxxxxx' ; 
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$db = 'test'; 




$oPDOLink — new pdo ( 
if ( ! $oPDOLink) { 

echo 'Connexion au 
} else { 

echo 'Connexion au 

} 


"pgsgl ; host— $host ussr— $user password-$pass" ) ; 
serveur PostgreSQL impossible' ; 
serveur PostgreSQL ef f ectuee avec succes ' ; 


/* Instructions */ 




$oPDOLink = NULL; 




?> 





(J) Les points-virgules comme separateurs 

Vous verrez souvent dans les exemples, sur Internet ou dans des ouvrages specialises, les parametres du 
DSN separes par des espaces (comme indique dans le script connexion_pgsql.php en ce qui concerne 
PostgreSQL. Afin de respecter une norme au sein de PDO, il est preferable de toujours utiliser les 
points-virgules ( ; ) comme separateurs. 

Deconnexion 

La deconnexion est sans commentaires tellement celle-ci est simple. 

$oPDOLink = NULL; 

PDO et les exceptions 

PDO est constitute de trois classes qui sont PDO, PDOStatement et PDOException. Cela 
signifie que PDO gere son propre systeme d'exceptions meme si la classe PDOException 
herite de la classe generique Exception de PHP 

Pour simplifier les exemples suivants, deux fichiers vont etre crees et qui seront appeles 
par un require_once() dans les exemples. Un sera consacre a MySQL (connect _mysql 
.inc.php) : 

connect_mysql. inc.php 

<?php 

$host = 'localhost'; 
$user = ' root' ; 
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$pass = 'xxxxxxx'; 
$db = ' test' ; 

try { 

$oPDOLink = new pdo ( "mysql : host=$host ; dbname=$db" , $user, $pass) ; 
} catch (Exception $e) { 

print (' Erreur '. $e->getMessage ( ) ) ; 

} 

?> 

Et 1' autre a PostgreSQL (connect _pgsql.inc.php) : 
connect_pgsql.inc.php 

<?php 

$host = ' localhost' ; 
$user = 'postgres'; 
$pass = 'xxxxxxx'; 
$db = ' test' ; 

try { 

$oPDOLink = new pdo ( "mysql : host=$host ; dbname=$db" , $user, $pass) ; 
} catch (Exception $e) { 

print (' Erreur '. $e->getMessage ( ) ) ; 

} 

?> 



Manipulations des donnees 
Executer des requetes 

II y a deux methodes pour executer des requetes avec PDO qui sont exec() et query (). 
Cependant, il y a une difference entre ces deux fonctions qui ne sont pas anodines. exec() 
retourne un entier qui represente le nombre de lignes affectees par la requete. query () 
retourne soit un objet de type PDOStatement, soit un booleen selon les parametres qui sont 
passes dans la fonction. II existe une syntaxe possible pour exec() et quatre autres pour 
query () : 

int exec(string statement); 

PDOStatement PDO: :query (chai ne statement); 
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bool PDO: :query (chai ne statement, entier PDO: : FETCH_COLUMN, entier 
col_no) ; 

bool PDO: :query(chai ne statement, entier PDO: : FETCH_CLASS, chaine class, 
tableau ctoargs); 

bool PDO: :query(chai ne statement, entier PDO: : FETCH_INTO, objet object); 

Les differences entre ces cinq syntaxes seront decrites un peu plus loin dans ce chapitre. 

A titre d'exemple, creez dans une base de donnees nommee test une table nommee users 
qui contient les colonnes use_id, use_login, use _password, use _prenom et use_nom et 
inserez-y plusieurs lignes. Faites ceci avec MySQL et PostgreSQL : 

J^jt tablejogins.sql 

CREATE TABLE logins ( 

login char (15) NOT NULL, 
pass char (80) NOT NOLL, 
prenom CHAR (30) NOT NULL, 
nom CHAR (30) NOT NULL, 
PRIMARY KEY (login) 

) ; 

INSERT INTO logins VALUES (' ddrapeau' , SHA1 ( ' xxxxxxxx' ) , 

' david' , ' drapeau' ) ; 
INSERT INTO logins VALUES (' fsuire' , SHA1 (' xxxxxxxx' ) , 

' f rederic' , ' suire' ) ; 

Lire dans une table 

Vous allez maintenant afficher le contenu de la table logins avec MySQL, PostgreSQL, 
PDO MySQL et PDO PostgreSQL. Vous verrez ainsi la difference entre l'utilisation des 
drivers natifs de chaque SGBD et de celle de PDO (mysql et pgsql). 

Drivers natifs 

Utiliser les drivers natifs oblige a connaitre les fonctions typiques au SGBD utilise. Par 
exemple, vous utilisez MySQL depuis des annees et on vous demande pour un projet 
d'utiliser PostgreSQL : vous etes dans la necessite d'etudier PostgreSQL et cela va vous 
prendre beaucoup de temps et d'energie. Heureusement, les deux se ressemblent 
beaucoup mais ont chacun des particularites et des differences. 
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MySQL 



lire_logins_mysql.php 


<?php 

$host = 'localhost'; 
$user = ' root' ; 
$pass = 'xxxxxx'; 
$db = ' test' ; 
$table = 'logins'; 




$hnk = mysql connect ($server, $user, $pass) ; 
mysql select db($db); 




$request = "SELECT login, prenom, nom FROM ". $table; 
$result = mysql query ( $request ) ; 




while ($ligne = mysql fetch array ($result) ) { 

echo $ligne [' login' ] .' '. ucf irst ( $ligne [' prenom' ] ) 
strtoupper ( $ligne [ ' nom' ] ) .'<br/>'; 

} 


r r 


mysql close ( $link) ; 
?> 





PostgreSQL 



lire_logins_postgresql.php 

<?php 

$host = 'localhost'; 
$user = 'postgres'; 
$pass = 'xxxxxx'; 

$db = ' test' ; 
$table = 'logins'; 

$link = pg_connect ( "host=$host dbname=$db user=$user password=$pass" ) ; 

$request = "SELECT login, prenom, nom FROM ". $table; 

$result = pg_query ( $request ) ; 

while ($ligne = pg_f etch_array ( $result ) ) { 
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echo $ligne [' login' ] .' '. ucf ir st ( $ligne [ ' prenom' ] ) 
strtoupper ( $ligne [ ' nom' ] ) . '<br/>'; 

} 


1 f 


pg close ( $link) ; 




?> 





PDO 

En utilisant PDO, vous n'avez plus besoin de modifier toutes les fonctions dans tous les 
scripts. Vous utilisez les fonctions PDO avec MySQL. Et si pour une mission, vous devez 
utiliser un autre SGBD que supporte PDO, vous n'aurez pas a apprendre les fonctions de 
1' autre SGBD et continuerez a utiliser les fonctions PDO. Done, le temps et l'energie 
economises sont immenses. 

pdojnysql 



lire_logins_pdo_mysql.php 

<?php 

// Definition des variables 
$host = ' localhost' ; 
$user = ' root' ; 
$pass = 'xxxxxxx'; 

$dbname ='test'; 
$table = 'logins'; 

$pdc = new pdo ( "mysql : hostname=$host; dbname=$dbname" , $user, $pass) 
or die ( "Erreur<br/>" . $e->getMessage ( ) ) ; 

$sql = "SELECT login, prenom, nom FROM ". $table; 
$result = $pdc->query ( $sql ) ; 
while ($ligne = $result->f etch ( ) ) { 

echo $ligne [' login' ] .' '. ucf irst ( $ligne [' prenom' ] ) .' '. 
strtoupper ( $ligne [' nom' ] ) .'<br/>'; 

} 

$pdc = NULL; 
?> 
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pdo _pgsql 

On vous demande de faire la meme chose avec PostgreSQL depuis la migration de la base 
de donnees ? C'est tres facile. La seule chose a modifier dans le script est la ligne 
suivante : 

$pdc = new pdo("mysql :hostname=$host;dbname=$dbname" , $user, $pass); 

Et il vous suffit de placer dans les parentheses : 

"pgsql :host=$host;dbname=$dbname;user=$user;password=$pass" 

Ce qui donne, pour le script complet : 

lire_logins_pdo_pgsql.php 

<?php 

// Definition des variables 
$host = ' localhost' ; 
$user = 'postgres'; 
$pass = 'xxxxxx'; 

$dbname ='test'; 
$table = ' logins' ; 

$pdc = new 

pdo ( "pgsql : host = $ host; dbname=$dbname; user=$user ; password=$pass" ) 
or die ( "Erreur<br />" . $e->getMessage ( ) ) ; 

$sql = "SELECT login, prenom, nom FROM ". $table; 
$result = $pdc->query ( $ sql ) ; 
while ($ligne = $result->f etch ( ) ) { 

echo $ligne [' login' ] .' '. ucf irst ( $ligne [' prenom' ] ) .' '. 
strtoupper ( $ligne [ ' nom' ] ) .'<br/>'; 

} 

$pdc = NULL; 
?> 

Bien stir, il faut aussi remplacer les valeurs des variables si celles-ci sont differentes. C'est 
pour cette raison que dans beaucoup d'ouvrages, meme de tres bonne qualite, il vous est 
souvent conseille de creer un fichier defines.inc.php dans lequel l'auteur vous conseille de 
definir toutes les constantes du projet ainsi que les parametres de connexion au SGBD 
concerne et de definir dans ce meme fichier de configuration le DSN pour l'utilisation de 
PDO. Ensuite, vous appelez ce fichier dans vos scripts de la facon suivante : 
requi re_once( 1 def i nes. i nc .php 1 ) 
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Cette fa9on de faire est deconseillee car a chaque fois que vous allez appeler ce fichier, 
que ce soit par include(), include_once(), require() ou requi re_once(), toutes les 
constantes seront automatiquement definies et pas uniquement celles que vous utiliserez 
dans le fichier appelant. Done, si pour un gros projet, vous avez dans ce fichier deux cents 
ou trois cents constantes, voire plus... Cela prend de la place en memoire et en outre 
allonge largement le temps d'execution dans le script. II suffit d'utiliser les fonctions de 
tracing avec Xdebug et de sauvegarder les resultats dans un fichier de trace. C'est 
deconcertant ! Evidemment, ce serait trop fastidieux de definir les constantes dans tous les 
fichiers PHP. Imaginez un projet avec cent fichiers et tous utilisant l'acces aux bases de 
donnees ! S'il est necessaire de changer le nom d'une base de donnees, cela signifie 
autant de fichiers a modifier. Ce n'est vraiment pas pratique. 

La methode ici mise en place est une classe qui fonctionne comme le fichier defines, inc 
.php a la difference que quand on appelle la classe par i ncl ude(), ou l'une des trois autres 
methodes, rien n'est defini par avance. Cela ne prend done aucune place en memoire. II 
suffit ensuite d'instancier un objet de la classe, et seules les methodes de classe utilisees 
prendront de la place en memoire. 

ClassDefine.php 

<?php 
/** 

* / include/ClassDef ine . php 

* Cette classe definit les variables qui sont considerees 

* comme statiques Certaines changent lorsqu'on change 

* d' environnement d' hebergement 

* (la plupart gardent la meme valeur) 
*/ 

class ClassDefine { 

// Definitions des variables de classe 
private $ server = ' localhost' ; // Serveur SQL 
private $_user = 'postgres'; // Utilisateur SQL 
private $ password = 'xxxxxx'; // Password SQL 
private $_dbname = 'test'; // Nom de la BDD PostgreSQL 
private $ tablename = null; 

/** Definitions des methodes **/ 

/ / Constructeur 

public function construct (){ } 
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// Destructeur 

public function destruct(){} 

public function getSQLServer ( ) { 
return $this-> server; 

} 

public function getSQLUser ( ) { 

return $this-> user; 

} 

public function getSQLPassword ( ) { 
return $this-> password; 

} 

public function getSQLDatabase ( ) { 
return $this-> dbname; 

} 

public function getSQLTable ( $tablename) { 
return $this-> tablename = $tablename; 

} 

} 

Et voici a present un exemple de connexion pour un fichier PHP appelant cette classe et 
qui utilise PostgreSQL : 

connexion_via_ClassDefine.php 

<?php 

require once ( ' ClassDef ine . php' ) ; 

$D = new ClassDef ine () ; 
$host = $D->getSQLServer ( ) ; 
$dbname = $D->getSQLDatabase ( ) ; 
$user = $D->getSQLUser ( ) ; 
$password = $D->getSQLPassword ( ) ; 

$oLink = new PDO ( "pgsql : host=$host dbname=$dbname 
user=$user password=$password" ) ; 

/** Instructions **/ 
?> 
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Ecrire dans une table 

Vous venez de voir dans la section precedente Lire dans une table a quel point la meme 
action dans deux SGBD differents est identique. Changer de SGBD demande de changer 
uniquement les parametres de connexion dans le constructeur et leurs valeurs. Rien 
d' autre. Ce qui prouve bien que vous pouvez vous concentrer uniquement sur le code 
SQL. Du fait de cette simplicite, et du fait aussi que dans beaucoup de manuels, PDO est 
explique avec MySQL, tous les exemples qui vont suivre seront ecrits avec 
PDO PostgreSQL. Cela vous fournira des exemples et des informations complementaires. 

Dans les exemples de lecture dans une table avec PDO, vous avez utilise la fonction 
query() et non exec(). Pourquoi ? Parce que dans le cas d'une lecture ou du contenu est 
retourne, les donnees se trouvant dans la table SQL repondent aux criteres de la requete 
SQL SELECT. 

Contrairement a un SELECT, lors d'une ecriture dans la table SQL (INSERT), il n'y a pas 
de contenu de retourne mais seulement une valeur de retour pour signaler si tout s'est 
bien passe ou non. II faudra done utiliser la fonction exec() et non query (). 

ecrire_logins_pdo_pgsql.php 

<?php 

// Definition des variables 
$host = ' localhost' ; 
$user = 'postgres'; 
$pass = 'xxxxxx'; 

$dbname ='test'; 
$table = 'logins'; 

$pdc = new pdo ( "pgsql : host=$host ; dbname=$dbname; user 
=$user ; password=$pass" ) 

or die ( "Erreur<br/>" . $e->getMessage ( ) ) ; 

$sql = "INSERT INTO logins VALUES (' rroberto' , ' passroberto' , 'rinaldo', 

' roberto' ) " ; 
$result = $pdc->exec ( $sql ) ; 
if ( ! $result) { 

echo ' Insertion dans la table echouee' ; 
} else { 

echo 'Insertion dans la table effectuee avec succes' ; 

} 
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$pdc = NULL; 
?> 

Remplacez exec() par query () pour l'ecriture et le message "Insertion dans la table 
echouee" apparaitra dans le navigateur. 

Utiliser les exceptions 

La version 5 de PHP integre la gestion des exceptions par defaut. Si vous ne maitrisez pas 
encore ce domaine, etudiez-le. Utiliser la fonction di e () , tel que cela a ete fait jusqu'a 
present, n'est vraiment pas un gage de qualite, ni de securite. Cela demontre meme une 
certaine incompetence tout comme 1' usage de la fonction md5() alors qu'il a ete prouve 
que des collisions etaient possibles en utilisant cette fonction de cryptage. Mieux vaut 
utiliser la fonction shal() tout aussi simple a utiliser et beaucoup plus sure. 

PDO contient trois classes dont deux deja utilisees et une troisieme que vous allez 
decouvrir maintenant. II s'agit de la classe PDOException qui herite de la classe Exception 
de PHP Analysons la classe PDOException : 

La classe PDOException contient six methodes que vous pouvez utiliser et qui sont les 
suivantes : 

getMessage() retourne le code erreur et le message d'erreur de PDO. 

getCode() retourne la valeur retournee par le code (c'est-a-dire la valeur 

numerique 0). 

getFile() retourne le nom du fichier (chemin complet) ou a ete generee l'erreur. 
getLine() retourne le numero de ligne du fichier ou a ete generee l'erreur. 
getTrace() retourne le type contenant le tracing (Array). 

getTraceAsStri ng() retourne les memes informations que getCode(), get Fi 1 e ( ) , 
getLine() associees avec, en plus, la fonction PDO qui a genere l'erreur. 

Pour ceux qui utilisent deja la classe Exception, il est facile de remarquer qu'elles sont 
identiques. PDOException recupere les methodes de la classe Exception et definit ses 
propres codes et messages d'erreurs. 

Executez le script exceptions _pdo.php dans votre navigateur et regardez le resultat par 
vous-meme. Vous comprendrez tout de suite. 

exceptions_pdo.php 

<?php 

$host = 'localhost'; 
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$user = 'postgres'; 

$pass = 'mauvais_password' ; 

$db = 'test'; 



try { 
$pdc 



new pdo ( "pgsql : host =$ host ; dbname=$db ;user=$user; 
password=$pass" ) ; 
echo 'connexion reussie' ; 
catch (PDOException $e) { 

echo 'getMessage : '. $e->getMessage ( ) . '<br/>'; 

echo 'getCode : '. $e->getCode ( ) .'<br/>'; 

echo 'getFile : '. $e->getFile ( ) .'<br/>'; 

echo 'getLine : ' . $e->getLine ( ) .'<br/>'; 

echo 'getTrace : '. $e->getTrace ( ) . '<br/>'; 

echo ' getTraceAsString : <pre>' . $e->getTraceAsString ( ) 



' </pre><br/>' 



$pdc = NULL; 
?> 



getMessagei I SQLSTATE[08006] [7] FATAL: password authentication failed for user "postgres" 
getCodeO : 

ijMtFil"! I ' .' ':::iju[ i 'Jii- 1- ■■: .'■ i7ii Lia:r:j li] '':l :i M ' 'r::':r[ ti- ■ ■■ [lip 
getLiiieO : 11 
getTraceO : 

Array 

[ 

[0] => Array 
( 

(ilk) - 7 :U iff ■. 1 1 - . ■ I ,ii rut j: ~ - _ _■ t » f : ■- Inf U :'■ ~f ' i vii- _f . y if 

[line] => 11 

[function] => construct 
[class] => PDO 
[type] -> -> 
[args] -> Array 
( 

[0] => pgsql : host= localhost ; dbname=test; user=postgres ; passward=lBauvais password 

) 

) 

) 

getTraceAsStringt ) 

#0 C : \ xampp\ lit doc s\ dynamise s_php\ chapO 6 \ except ions_pdo . php (11) : PDO-> construct ( ' pgsql: ho st=loca. . . 

#1 {main} 



Fig. 6.2 : Les exceptions PDO 



222 



Check-list 6 



6.3 Check-list 

Dans ce chapitre, nous avons vu : 

1' installation PostgreSQL sur Windows et Linux ; 
les connexions via PDO ; 
comment ecrire une classe de connexion ; 
comment utiliser des fonctions PDO ; 
>/ comment utiliser les exceptions. 
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Dynamiser 
PHP5 avec 
Classkit 

Grace a PHP et d certaines extensions, comme les 
deux qui vont etre expliquees dans ce chapitre, il est 
possible de supprimer une fonction dangereuse le temps 
de I'execution d'un script et de supprimer ainsi une fai le 
de securite. Cela, sans rien modifier en dur dans les 
fichiers .php et en quelques lignes de code seulement. 



7 Dynamiser PHP5 avec Classkit 



7. 1 Classkit : dynamiser vos classes 

Classkit est une extension PHP qui permet d'agir dynamiquement sur les classes. Les 
fonctionnalites sont limitees, cependant, vous pouvez tout de meme ajouter 
dynamiquement une methode dans une classe et meme importer de nouvelles definitions 
de classe d'un fichier. Vous pouvez egalement renommer, copier, supprimer et redefinir 
dynamiquement les methodes d'une classe. Comme pour beaucoup d'extensions, pour 
installer Classkit sous Windows (avec XAMPP en tout cas), vous avez juste a 
decommenter la ligne dans le php.ini et a redemarrer Apache. Puis, vous ouvrez votre 
superprogramme qui contient la ligne de code magique <?php phpinfo() ;?> et la, vous 
devriez voir un cadre consacre a l'extension Classkit. 

| ► Fig. 7.1 : 

classkit L'extension Classkit 



classkit support 


enabled 


version 


0.4 





Classkit ne contient aucune directive a placer dans le php.ini. Tout se passe dans le code 
PHP. Voici un premier exemple dans lequel une methode est renommee via Classkit. Tout 
d'abord, il est necessaire de definir une classe. Vous pouvez utiliser la classe definie dans 
le script classe _UneClasse.php. Observez bien le nom de la methode. 

^ classeJJneClasse.php 

<?php 

class UneClasse { 

function construct (){ } 

function destruct ( ) { } 

public function uneMethode ($argl, $arg2, 

$defautlArg = 'Bonjour') { 
$salut = $defautlArg .' ' . $argl .' ' . $arg2; 

return $salut; 
} 

} 

?> 
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Vous pouvez voir que l'unique methode definie dans cette classe se nomme uneMethode () 
et qu'elle comprend trois arguments dont le troisieme est optionnel puisqu'une valeur par 
defaut lui a ete affectee. 

Les fonctions de Classkit 
Renommer une methode 

Maintenant, nous allons utiliser la methode cl asski t_method_rename () arm de renommer 
uneMethode() pour lui donner le nouveau nom suivant : 1 aNouvel 1 eMethodeQ. 

bool cl asski t_method_rename(chai ne $nom_cl asse, 

chaTne $nom_methode, chaTne $nouveau_nom_methode) 

cl asski t_methode_rename() prend trois arguments. Le premier ($nom_cl asse) est le nom 
de la classe dans laquelle se trouve la methode ($nom_methode) a renommer. Le deuxieme 
argument ($nom_inethode) est le nom de la methode a renommer et le troisieme argument 
($nouveau_nom_methode) est le nouveau nom que Ton va justement donner a la methode 
ciblee au deuxieme argument, cl asski t_method_rename() retourne true en cas de succes 
et false en cas d'echec. Le script renommer _methode.php montre un exemple qui 
renomme dynamiquement une methode : 

ck_renommer_methode.php 

<?php 

// On inclut le fichier dans lequel on a defini la classe 
// et la methode que l'on va renommer 
require once ( ' classe_UneClasse . php' ) ; 

// On instancie un objet de la classe 
$CCK = new UneClasse ( ) ; 

// Avant de renommer, on appelle avec le nom d'origine 

echo '<b>appel avec le nom dVorigine :</b> ' ; 

echo $CCK->uneMethode (' David' , ' DRAPEAU' ) . ' <br />' ; 

/ / Renommer la methode uneMethode ( ) 
// qui va s'appeler maintenant laNouvelleMethode ( ) 
$renommer = classkit method rename (' Uneclasse' , 
' uneMethode' , ' laNouvelleMethode' ) ; 
if ($renommer) { 

echo '<bxfont color="blue"> 

methode renommee avec succes 
</f ontx/b><br/>' ; 
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} else { 

echo ' <bxf ont color="red"> 

impossible de renommer la methode 
</f ontx/bXbr/>' ; 

} 

// Puis on utilise la methode renommee precedemment 

// en utilisant son nouveau nom 

echo '<b>appel avec le nouveau nom : </b>' ; 

echo $CCK->laNouvelleMethode (' David' , ' DRAPEAU' ) . '<br/>'; 

/ / Puis on appelle a nouveau par le nom d' origine 
echo '<b>appel a nouveau avec le nom d\' origine :</b> '; 
echo $CCK->uneMethode ('David' , 'DRAPEAU') .'<br />' ; 
?> 

Le resultat est affiche par le script ck_renommer_methode.php. 



appel avec le nom d'origine : Bonjour David DRAPEAU 
methode renommee avec succes 

appel avec le nouveau nom : Bonjour David DRAPEAU 
appel a nouveau avec le nom d' origine : 

Fatal error: Call to undefined method UneClasse::uneMethodeQ in C:\Pr 



Lors de l'appel de la fonction avec le nom d'origine (uneMethodeQ) et avant de l'avoir 
renommee, la fonction existe bien et fait ce qu'elle doit faire. Une fois renommee 
1 aNouvel 1 eMethode() , si Ton appelle la meme fonction par son nouveau nom, elle est 
toujours fonctionnelle. Par contre, si on l'appelle a nouveau avec son nom d'origine 
(uneMethode()), elle genere cette fois une erreur fatale, puisque pour PHP, elle n'existe 
plus sous son nom d'origine. 

Supprimez les deux lignes qui generent l'erreur fatale ainsi que la ligne de commentaire 
qui y est associee : 

// Puis on appelle a nouveau par le nom d'origine 

echo '<b>appel a nouveau avec le nom d\' origine :</b> ' ; 

echo $CCK->uneMethode (' David' , 'DRAPEAU') .'<br />' ; 

Placez maintenant un lien, apres la balise ?>, qui va pointer vers un fichier dans lequel 
vous allez appeler la methode avec son nouveau nom. Le lien est : 

<a href="methode_renommee.php">Methode renommee</a> 

Le script ck_methode_renommee.php montre les trois lignes de codes a utiliser. II serait 
tres difficile de faire plus simple : 



Le script 

ck_renommer_methode. php 
execute dans le 
navigateur 
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ck_methode_renommee.php 

<?php 

require_once ( ' classe_UneClasse . php' ) ; 

// On instancie un objet de la classe 
$CCK = new UneClasse ( ) ; 



// Puis on utilise la methode renommee precedemment 
// en utilisant son nouveau nom 

echo $CCK->laNouvelleMethode (' David' , ' DRAPEAU' ) . '<br/>'; 
?> 



Et void ce qui s'affiche dans le navigateur a l'execution du script. 

Fig. 7.3 

'igateur 



I 1 Fig. 7.3 : 

[Fatal error: Call to undefined method UneClasse::laNouvelleMethodeO in C:\Prl Exemple d'affichage 

' I dans le naviqateur 



Alors, vous etes surpris ? 



/j\ Code dynamique, ecriture dans fichier 



Ce n'est pas parce que vous avez modifie dynamiquement le code que la modification s'est inscrite en 
dur en modifiant le fichier PHP. Pour cela, vous devez utiliser les fonctions de lecture et d'ecriture dans 
les fichiers. 



Si vous ouvrez le fichier PHP, vous verrez que le code n'a change en rien. Et c'est pour 
cela que quand vous cliquez sur le lien pour executer le script ck_methode_renommee.php 
dans le navigateur en gardant le nouveau nom de la methode (1 aNouvel 1 eMethode()), 
PHP genere une erreur fatale. Pour executer a nouveau la methode dans ce script, ainsi 
que dans tous les autres oil la fonction n'a pas ete renommee auparavant, vous devez 
utiliser le nom d'origine (uneMethode()) de la methode. 

Aj outer une methode 

Nous avons suffisamment insiste sur la difference entre le code dynamique et l'ecriture 
dans un fichier. Voici a present comment ajouter dynamiquement une fonction a la classe 
UneClasse{} : 



ck_ajouter_methode.php 

<?php 

requireonce ( ' classe_UneClasse . php' ) ; 
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// On ecrit dans le heredoc les instructions 

// qui seront situees dans le corps de la fonction 

$code =«<codemethodeaj outee 

\$sum = \$numl + \$num2; 

return \$sum; 

codemethodea j outee ; 

// On ajoute une nouvelle methode dans la classe UneClasse 
// avec un acces public (CLASSKIT_ACC_PUBLIC ) 
// la fonction contient deux arguments 
classkit_method_add (' UneClasse' , ' methodeAj outee' , 
'$numl, $num2', $code, CLASSKIT_ACC_PUBLIC ) ; 

// creation d'un objet Example 

$oUC = new UneClasse () ; 

echo $oUC->methodeAj outee ( 12 , 14); 

?> 

La fonction est bien ajoutee a la classe. Mais elle Test dynamiquement. Si vous editez a 
nouveau votre fichier PHP dans lequel est defmie la classe, celle-ci n'a en rien change. 
Quelles que soient les manipulations que vous effectuerez avec l'extension Classkit, rien 
ne sera modifie en dur (ecrit) dans le fichier. La fonction utilisee pour ajouter 
dynamiquement du code est : cl as ski t_method_add(). 

bool cl asskit_method_add(chaTne $nom_cl asse, chaTne $nom_methode, 

chaTne $args, chaTne $code [, entier $drapeaux] ) 

Le premier parametre ($nom_cl asse) definit la classe dans laquelle la nouvelle methode 
va etre ajoutee. Le nom de la nouvelle methode est defini dans le deuxieme parametre 
($nom_methode). Le troisieme parametre ($args) definit la liste des variables qui seront 
integrees dans la nouvelle methode. Le quatrieme parametre ($code) represente le corps 
de la fonction dans lequel les instructions sont definies et le cinquieme parametre definit 
le type d' acces a la methode ajoutee. En ce qui concerne le cinquieme parametre, les 
valeurs pour le type d'acces sont definies par des constantes predefinies avec l'extension 
Classkit. Les constantes sont CLASSKIT_ACC_PRIVATE pour un acces prive, CLASSKIT 
_ACC_PROTECTED pour un acces protege et CLASSKIT_ACC_PUBLIC pour un acces public. 

Redefinir une methode 

Vous pouvez, avec Classkit, redefinir une methode, c'est-a-dire lui donner de 
nouvelles instructions et meme de nouveaux arguments. La fonction s'appelle 
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cl asski t_method_redef i ne() et elle effectue exactement la meme action que 
cl asski t_method_add () a la difference que cl asskit_method_add() cree une nouvelle 
fonction alors que cl asski t_method_redefine() recupere une fonction existante. 

bool cl asski t_method_redef i ne(chaTne $nom_cl asse, chaTne $nom_methode, 

chaine $args, chaTne $code [, entier $drapeaux]) 

Le role des arguments de la fonction cl asski t_method_redefi ne() est exactement le 
meme que pour ceux de la fonction cl asski t_method_add(). 

Supprimer une methode 

Avec Classkit, il est possible de supprimer une methode, que celle-ci soit definie 
dynamiquement par cl asski t_method_add () ou non. II suffit d'utiliser la fonction 
cl asski t_method_remove(). Cela peut s'averer necessaire pour securiser le code. Ainsi, 
vous pouvez supprimer dynamiquement une fonction dangereuse pour le script courant et 
pourtant indispensable pour d'autres scripts du projet. 

bool cl asski tjnethod_remove (chaTne $nom_cl asse, chaTne $nom_methode) 

Le premier argument est le nom de la classe dans laquelle se trouve la methode qui est 
elle-meme definie en second parametre de la fonction. 

7.2 Passer la vitesse superieure avec Runkit 

Runkit est une extension PHP plus evoluee que Classkit. D'ailleurs, Runkit possede ses 
propres constantes predefmies ainsi que les constantes predefmies de Classkit. Runkit agit 
sur les classes en cours d'execution mais pas seulement. Elle agit egalement sur les 
fonctions. Vous allez decouvrir qu'avec Runkit, il est possible d'exploiter le code PHP de 
facon plus evoluee qu'avec Classkit. 

Pour commencer, vous allez decouvrir les directives de configuration de Runkit a placer 
dans le php.ini. Ensuite, nous aborderons en premier lieu les fonctions de Runkit 
similaires a celles etudiees dans la premiere partie avec Classkit. Enfin, l'etude portera sur 
les fonctions de Runkit qui permettent d'effectuer des manipulations dynamiques sur le 
code PHP et qui sont impossibles avec l'extension Classkit. 

De meme que pour Classkit, installer Runkit via XAMPP est tres simple. II suffit d'editer 
le php.ini et de decommenter la ligne ;extensi on=php_runki t .dl 1 en supprimant le 
point-virgule (;) qui se trouve en debut de ligne. 
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Directives de configuration 

Runkit possede deux directives de configuration (a placer dans le fichier php. ini) qui sont 
run kit. super-global qui a pour valeur par defaut une chaine de caracteres nulle et 
runkit. internal_override qui a la valeur numerique par defaut. 

runkit.superglobal permet de definir les variables qui vont etre reconnues par le moteur 
PHP lui-meme. En fait, elles ont la meme portee que des variables superglobales bien plus 
connues qui sont $_GET, $_P0ST, $_SERVER, etc. 

runkit.internal_override = 1 permet de surcharger des fonctions internes a PHP en 
plus des fonctions definies par l'utilisateur. Par defaut, runkit. internal_override = et 
permet uniquement la surcharge de fonctions ecrites par le programmeur et non les 
fonctions internes a PHP. 

Fonctions similaires d Classkit 
Renommer une methode 

La fonction qui renomme une methode (fonction situee dans une classe) s'appelle 
runkit_method_rename(). Son fonctionnement est identique a cl asski t_method 
_rename() et ses argument sont les memes et ont les memes roles. 

bool runki t_method_rename(chaTne $nom_cl asse, chaine $nom_methode, chaTne 
$nouveau_nom) 

II ne faut pas confondre runki t_method_rename() qui agit sur une fonction definie dans 
une classe avec runki t_functi on_rename() qui agit sur une fonction definie hors de toute 
classe et qui sera etudiee un peu plus loin dans ce meme chapitre. Le script 
rk_renommer_methode.php montre un exemple tres simple de l'utilisation de 



runkit function renameQ : 


rk_renommer_methode.php 


<?php 

// On inclut le fichier dans lequel on 
// et la methode que l'on va renommer 
require once ('classe UneClasse . php' ) ; 


a defini la classe 


// On instancie un objet de la classe 
$CCK = new UneClasse () ; 




// Avant de renommer, on appelle avec 
echo '<b>appel avec le nom dVorigine 


le nom d' origine 
:</b> ' ; 
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echo $CCK->uneMethode (' David' , ' DRAPEAU' ) . ' <br />' ; 

// On renomme la methode uneMethode ( ) 

// qui va s'appeler maintenant laNouvelleMethode ( ) 

$renommer = runkit method rename (' Uneclasse' , 

' uneMethode' , ' laNouvelleMethode' ) ; 
if ($renommer) { 

echo ' <bxf ont color="blue"> 

methode renommee avec succes 
</f ontx/bXbr/>' ; 

} else { 

echo ' <bxf ont color="red"> 

impossible de renommer la methode 
</f ontx/b><br/>' ; 

} 

// Puis on utilise la methode renommee precedemment 

// en utilisant son nouveau nom 

echo '<b>appel avec le nouveau nom : </b>' ; 

echo $CCK->laNouvelleMethode (' David' , 'DRAPEAU') .'<br/>'; 

// Puis on appelle a nouveau par le nom d' origine 
echo '<b>appel a nouveau avec le nom dVorigine :</b> ' ; 
echo $CCK->uneMethode (' David' , 'DRAPEAU') .'<br />' ; 
?> 



Aj outer une methode 

La fonction qui ajoute une methode (fonction situee dans une classe) s' appelle 
runkit_method_add(). Son fonctionnement est identique a cl asski t_method_add () et ses 
argument sont les memes et ont les memes roles. 

bool runkit_method_add(chaTne $nom_cl asse, chaTne $nom_methode, chaTne 
$args, chaTne $code [, entier $drapeaux]) 

II ne faut pas confondre runki t_method_add () qui agit sur une fonction defmie dans une 
classe avec runki t_function_add() qui agit sur une fonction definie hors de toute classe 
et qui sera etudiee ulterieurement dans ce meme chapitre. Le script rk_ajouter_methode 
.php montre un exemple tres simple de l'utilisation de runki t_add_method() : 

rk_ajouter_methode.php 

<?php 

requireonce ( ' classe_UneClasse . php' ) ; 

// On ecrit dans le heredoc les instructions 
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// qui seront situees dans le corps de la fonction 
$code =«<codemethodea j outee 
\$sum = \$numl + \$num2; 
return \$sum; 
codemethodea j outee ; 

// On ajoute une nouvelle methode dans la classe UneClasse 
// avec un acces public (CLASSKIT_ACC_PUBLIC ) 
// la fonction contient deux arguments 
runkit_method_add (' UneClasse' , ' methode_aj outee ' , 
'$numl, $num2', $code, CLASSKIT_ACC_PUBLIC) ; 

// creation d'un objet Example 

$oCCK = new UneClasse (); 

echo $oCCK->methode_a j outee (12, 14); 

?> 

/\ Majuscule vs minuscule 

Si vous analysez le script ck_ajouter_methode.php, vous vous rendrez compte que le norm de la fonction 
ajoutee est methodeAjoutee() . Ce nom de methode avec Runkit generera un message d'erreur, lors de 
son appel, comme quoi PHP ne trouve pas la fonction demandee et dira que celle-ci n'existe pas. En 
effet, Runkit n'accepte que les noms de fonctions avec lettres minuscules et underscore (J. C'est pour 
cette raison que dans le script rk_ajouter_methode.php, le nom de la fonction d ajouter est 
methode_ajoutee() au lieu de methodeAjoutee() . 

Ce bug n'existe pas avec la fonction runkit_method_rename{) puisqu'il a ete possible de renommer la 
fonction uneMethode() par le nom laNouvelleMethode() dans le script rk_renommer_methode.php. 



Redefinir une methode 

(J) Chapitre 1 

Voici, comme promis, le bon login et le bon motde passe [password) du cas pratique du chapitre 1 au 
sujet de la compression : 

$bonlogin = shal ( ' yeahhh' ) ; 
$bonpassword = shal ( ' tropf ort' ) ; 

La fonction de l'extension Runkit qui redefmit une methode situee dans une classe 
s'appelle runkit_method_redefine(). Son fonctionnement est identique a la fonction de 
l'extension Classkit classkit_method_redefine() et ses argument sont les memes et ont 
les memes roles. 
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bool runki t_method_redef i ne(chaTne $nom_cl asse, chaTne $nom_methode, 

chaTne $args, chaTne $code [, entier $drapeaux]) 

II ne faut pas confondre runki t_method_redef i ne() qui agit sur une fonction definie dans 
une classe avec runki t_function_redefine() qui agit sur une fonction definie hors de 
toute classe et qui sera etudiee ulterieurement dans ce meme chapitre. Le script 
rk_modifier_methode.php montre un exemple concret de ce que fait la fonction 
runkit_method_redefine() : 

rk_modifier_methode.php 

<?php 

require_once ( ' classe_UneClasse . php' ) ; 

// On ecrit dans le heredoc les instructions 

// qui seront situees dans le corps de la fonction 

$code =«<codemethodea j outee 

\$sum = \$numl + \$num2; 

return \$sum; 

codemethodea j outee ; 

// On ajoute une nouvelle methode dans la classe UneClasse 
// avec un acces public (RUNKIT_ACC_PUBLIC ) 
// la fonction contient deux arguments 
runki t_method add (' UneClasse' , 'une some' , 

'$numl, $num2', $code, RUNKI T_ACC_PUBLIC ) ; 

// instanciation de la classe UneClasse 
$oUC = new UneClasse () ; 

echo 'La somme est : ' . $oUC->une somme(12, 14) ; 

// On redefinit la fonction une somme 
// qui va s'appeler un_produit 
// et qui va calculer le produit 
// des deux nombres $numl, $num2 . 

/ / On renomme la methode une somme 

// qui va s'appeler maintenant un produit 

$renommer = runkit method rename (' Uneclasse' , 

'une somme', ' un produit'); 
if ($renommer) { 

echo '<br/xbxfont color="blue"> 
methode renommee avec succes 
</f ontx/b><br/>' ; 

} else { 

echo '<br/xbxfont color="red"> 

impossible de renommer la methode 
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</f ontx/bxbr/>' ; 

} 

// On ecrit dans le heredoc les instructions 

// qui seront situees dans le corps de la fonction 

$code =«<codemethodea j outee 

\$sum = \$numl * \$num2; 

return \$sum; 

codemethodea j outee ; 

// Puis on redefinit la methode 

$redefinir = runkit method_redef ine ( ' UneClasse ' , 
' un produit' , '$numl, $num2', 
$code, RUNKIT_ACC_PUBLIC) ; 

if ( $redef inir ) { 

echo '<br/Xb><font color="blue"> 

methode redefinie avec succes 
</f ontx/bXbr/>' ; 

} else { 

echo '<br/xbxfont color="red"> 

impossible de redefinir la methode 
</f ontx/bXbr/>' ; 

} 

// On af f iche le resultat du produit 

echo ' Le produit est : '. $oUC->un_produit (12, 14); 

?> 



(J) CLASSKIT_ACC_* vs RUNKIT_ACC_* M 

Pour definir le type d'acces d la methode, avec Classkit, il y a CI_ASSKIT_ACC_PRIVATE, 
CLASSKIT_ACC_PROTECTED et CLASSKIT_ACC_PUBLIC. Avec Runkit, il y a RUNKIT_ACC_PRIVATE, 
RUNKIT_ACC_PROTECTED et RUNKIT_ACC_PUBLIC. 

Runkit a egalement la possibilite d'accepter les constantes CLASSKIT_ACC_* d la place des constantes 
RUNKIT_ACC_*, ce qui peut faire gagner enormement de temps le jour ou, par exemple, vous recuperez 
un projet qui contient beaucoup de code dynamique ecrit avec Classkit et que vous comptez I'ameliorer 
en utilisant Runkit. 

Supprimer une methode 

La fonction qui supprime dynamiquement une methode (fonction situee dans une classe) 
s'appelle runki t_method_remove() . Son fonctionnement est identique a 
cl asski t_method_remove() et ses argument sont les memes et ont les memes roles. 
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bool runki t_method_remove(chaTne $nom_classe, chaTne $nom_methode) 

II ne faut pas confondre runki t_method_remove() qui agit sur une fonction definie dans 
une classe avec runkit_function_remove() qui agit sur une fonction definie hors de toute 
classe et qui sera etudiee ulterieurement dans ce meme chapitre. 

J^jt rk_supprimer_methode.php 

<?php 

class UneClasse { 

public function methodeMortelle ( ) { 
return ' Je veux vivre ! ! ! ' ; 

} 

} 

$oUC = new UneClasse () ; 

echo ' avant suppression dynamique de la methode : '; 
echo $oUC->methodeMortelle () ; 
echo ' <br/xbr/>' ; 

runkit method remove (' UneClasse' , 'methodeMortelle'); 
echo ' apres suppression dynamique de la methode : ' ; 
echo $oUC->methodeMortelle () ; 

?> 



Depasser les possibilites de Classkit 

Avec Classkit et Runkit, vous avez jusqu'a present compris comment faire pour 
manipuler des fonctions definies dans des classes. PHP permet egalement de definir des 
fonctions directement dans des scripts sans pour autant les placer dans une classe. 
Reprenez les quatre fonctions precedentes et remplacez dans le nom de la fonction le mot 
method par le mot function et vous aurez memorise en deux secondes les noms des 
nouvelles fonctions que vous allez voir dans cette seconde partie. Vous l'avez compris, les 
quatre fonctions de Runkit qui vont suivre sont : runkit_function_add(), 
runkit_function_redefine(), runki t_functi on_rename() et, pour terminer cette partie, 
runkit_function_remove(). Supprimez ensuite le premier parametre (le nom de la 
classe) et le dernier (le type d'acces en ce qui concerne la fonction d'ajout et de 
redefinition) et vous aurez memorise, encore en deux secondes, la syntaxe de chacune de 
ces nouvelles fonctions. 
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Aj outer une fonction 

La fonction runki t_function_add() permet d'ajouter une nouvelle fonction dans le script 
courant. 

bool runki t_function_add(chaTne $nom_fonction, 

chaTne $liste_arguments, chaTne $code) 

II s'agit bien de fonction et non de methode. Autrement dit, celle-ci (la fonction) ne sera 
pas definie dans une classe. Le script rk _php_statique.php (premier exemple) montre 
l'utilisation d'une fonction telle que cela se fait en dur dans le script tandis que le script 
rk _php_dynamique.php (second exemple) montre l'utilisation de la meme fonction 
generee dynamiquement. 

Premier exemple 

fl^j rk_php_statique.php 



<?php 




function somme($a, $b) { 


return $a + 


$b; 


} 




echo somme ( 3 , 


7); 


?> 





Second exemple 

rk_php_dynamique.php 

<?php 

runkit function add (' somme' , '$a, $b' , 'return $a + $b; ' ) ; 

echo somme (12, 14); 
?> 

Modifier une fonction 

La fonction runki t_functi on_redefi ne() permet de redefinir une fonction situee dans le 
script courant. 

bool runki t_functi on_redefi ne(chaine $nom_fonction, 
chaTne $1 i ste_arguments, chaTne $code) 
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Renommer une fonction 

La fonction runkit_function_rename() permet de renommer une fonction situee dans le 
script courant. 

bool runki t_function_rename(chaTne $nom_fonction, chaTne $nouveau_nom) 
Supprimer une fonction 

La fonction runkit_function_remove() permet de supprimer une fonction situee dans le 
script courant. 

bool runki t_function_remove(chaTne $nom_fonction) 
Jouer avec les constantes 

Tout comme pour les fonctions et les methodes, Runkit gere aussi les constantes. Vous 
pouvez creer une constante, la modifier et/ou la supprimer. 

bool runki t_constant_add (chaTne $nom_constante, mixte $valeur) 

bool runkit_constant_redefine(chaTne $nom_constante, mixte $nouvel le_valeur) 

bool runki t_constant_remove(stri ng $nom_constante) 

La difference entre runki t_constant_add() et runki t_constant_redefine() est que la 
premiere cree une constante qui n'existe pas avant l'appel de la fonction et que la seconde 
fonction recupere une constante existante aim de lui affecter une nouvelle valeur. 

Le script rk_constantes.php montre un exemple des fonctions runki t_constant_add(), 
runki t_constant_redef i ne() et runki t_constant_remove(). 

<^jt rk_constantes 

<?php 

runkit_constant_add('NOMBRE' , 3) ; 

echo 'La constante creee a pour valeur '. NOMBRE; 
// affiche: la constante creee a pour valeur 3 

runkit_constant_redef ine ( ' NOMBRE' , 12 ) ; 
echo '<br/>La constante a ete redefinie 

avec la valeur ' . NOMBRE; 
// affiche: la constante a ete redefinie avec la valeur 12 

runkit_constant_remove ('NOMBRE' ) ; 

echo '<br/>La constante a ete suppr imee . ' ; 
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echo ' Elle a pour valeur ' . NOMBRE; 

// affiche: La constante a ete supprimee. 

// Elle a pour valeur NOMBRE 

?> 

Le premier echo affiche bien la valeur de la constante definie avec 
runki t_constant_add () ainsi que le deuxieme echo qui affiche tout autant la nouvelle 
valeur de la constante redefinie avec runki t_functi on_redefi ne() . Cependant, le 
troisieme echo affiche NOMBRE parce que la constante NOMBRE a ete supprimee grace a la 
fonction runki t_constant_remove() et echo considere done NOMBRE comme une chaine, 
bien que celle-ci ne soit pas placee entre guillemets, et non comme une constante. 

Agir sur les classes 

Deux fonctions permettent d'agir sur les classes et comme toujours, leur nom est tres 
explicite. La premiere permet de creer un heritage et se nomme runki t_cl ass_adopt () et 
la seconde fait Taction inverse et s'appelle runkit_class_emancipate(). Voici un 
exemple hors informatique. Vous etes une personne adulte avec une certaine situation 
stable et vous desirez adopter un enfant ; celui-ci heritera de vous alors qu'a l'inverse 
vous etes un pere (ou une mere) et vous ne supportez plus votre enfant et vous ne voulez 
pas qu'il herite de vos richesses : alors vous l'emancipez. C'est exactement la meme 
chose avec les deux fonctions citees precedemment. Le script rk_adopter_emanciper.php 
montre un exemple tres simple et tres concret de 1' adoption et de l'emancipation 
dynamique des classes : 

bool runki t_cl ass_adopt (chaTne $nom_cl asse_enf ant , 

chaine $nom_cl asse_parent) 

bool runki t_cl ass_emanci pate(chaine $nom_cl asse_parent) 
rk_adopter_emanciper.php 

<?php 

class ClasseAdulte { 

..public function messagelmportant ( ) { 
....return "J'ai adopte un enfant"; 
• • } 
} 

class ClasseEnfant { 
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} 

$oEnfant = new ClasseEnf ant () ; 

/ / echo $oEnf ant->messageImportant ( ) ; 

runkit_class_adopt ('ClasseEnf ant', ' ClasseAdulte ' ) ; 
echo $oEnf ant->messageImportant ( ) ; 

runkit class emancipate (' ClasseParent' ) ; 

echo $oEnf ant->messageImportant ( ) ; 

?> 

A la ligne 13, il y a une instruction mise en commentaire. Cette ligne appelle la fonction 
messagelmportant () de la classe ClasseAdulte avant que celle-ci ait adopte la classe 
ClasseEnf ant : cela genere une erreur fatale et stoppe le script adopter _emanciper.php 
aussitot apres cette instruction lorsque cette ligne est decommentee. 

7.3 Conclusion 

Vous voici maintenant arme pour utiliser correctement Runkit arm de generer du code 
dynamique et faire evoluer considerablement vos connaissances et votre facon de 
programmer. La seule limite au codage dynamique en PHP est votre imagination. Le code 
PHP, qui n'a plus rien a envier a Java ou a C++ en termes de possibilites, est devenu 
tellement puissant que les limites seront celles que vous vous imposerez (consciemment 
ou inconsciemment). 

7.4 Check-list 

Avec Classkit, nous avons appris a : 

>/ aj outer des methodes de maniere dynamique ; 
</ les renommer ; 
>/ les redefinir ; 
«/ les supprimer. 

Avec Runkit, nous avons appris a : 

>/ effectuer le meme travail qu'avec Classkit ; 

manipuler les fonctions ; 
</ creer/detruire des heritages de classes. 
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8.1 Les classes de Reflection 

8.2 Reflection et ReflectionClass : dissequer une classe en 
une ligne de code 

8.3 Tout connaTtre d'une fonction 

8.4 ReflectionMethod : on entre dans la classe 

8.5 Cas pratique : un systeme de plug-ins 

8.6 Check-list 




Dynamiser 
le code avec 
Reflection 

Cet article fait exception d la regie du livre, car il ne 
s'agit pas Id d'une extension mais d'une 
API [Application Programming Interface) faisant partie de 
la version objet de PHP5. Cette API a pour nom de 
bapteme Reflection, aussi appelee introspection. Utilisee 
correctement, elle peut vous permettre de vous documenter 
sur une librairie PHP, sur des fonctions et des extensions 
internes ou externes d PHP. 
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8. 1 Les classes de Reflection 

L'API de reflexion est principalement utilisee pour la POO (Programmation orientee 
objet). Les classes sont les suivantes : 

class Reflection!} 

■ interface Reflectory} 

class ReflectionException extends Exception!} 

■ class ReflectionFunction implements Reflector{} 
class Refl ectionParameter implements Reflector{} 
class ReflectionMethod extends ReflectionFunction{} 
class ReflectionClass implements Reflector{} 
class Refl ectionObject extends ReflectionClass{} 

■ class ReflectionProperty implements Reflector{} 
class ReflectionExtension implements Reflector{} 

8.2 Reflection et ReflectionClass : dissequer une classe en 
une ligne de code 

Comme nous venons de l'ecrire, utiliser la reflexion est un excellent moyen pour etudier 
une classe PHP dans sa totalite. Reflection et ReflectionCl ass permettent de dissequer 
une classe et de savoir tres precisement comment elle est constituee. La fonction qui 
recupere toutes les donnees de la classe et les affiche dans le navigateur se nomme 
export(). 

Reflection: :export(mixte $nom_classe, bool $retour) 

En cas de succes, export () retourne une chaine, ou plutot un tableau, que vous pouvez 
tres facilement formater en utilisant les balises <prex/pre>. On pourrait considerer que 
export () pour la classe Reflection{} est l'equivalent de print_r() pour les tableaux. 

methode_export.php 

<?php 

// Choisir une classe 
$classname = 'Reflection'; 

echo ' <pre>' ; 

// Voici LA ligne qui affiche 

// toutes les informations de la classe 
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Reflection: :export (new ReflectionClass ($classname) ) ; 

echo ' </ pre>' ; 

?> 



Le resultat de l'execution dans un navigateur de methode_export.php est visible sur la 
figure suivante : 



T | El http://localhost/dynamisez_php/ chap[ 



Class [ class Reflection ] { 



Constants [0] { 



Static properties [0] { 



Static methods [2] { 

Method [ static public method getHodif ierNames ] { 



Parameters [1] { 

Parameter #0 [ ^modifiers ] 



Method [ static public method export ] { 

- Parameters [2] { 

Parameter #0 [ Reflector ^reflector ] 
Parameter #1 [ ^return ] 



► Fig. 8.1 : 

La classe Reflection 
dissequee 



- Properties [□] { 

} 

- Methods [0] { 

} 

} 



Voici quelques explications sur le resultat affiche dans le navigateur. La premiere ligne 
CI ass [classe Reflection] indique le nom de la classe. La ligne Constants [0] indique 
que la classe Reflection ne contient aucune constante dans son corps. C'est la meme 
chose pour les proprietes statiques : Static properties [0] . En ce qui concerne les 
methodes statiques, la classe Reflection en possede deux qui ont toutes deux un acces 
public (public). La quantite de parametres d'une fonction est signalee par la ligne 
Parameters [0] . Et la description du premier argument est signalee par la ligne Parameter 
#0 [...] . La suite est tout aussi simple a comprendre. 

Si la classe n'existe pas, un message d'erreur fatale est affiche dans le navigateur et le 
script est stoppe immediatement apres la generation de l'erreur. Le script 
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err_appel_xdebug.php montre un exemple avec Xdebug appelee par Reflection et qui 
genere un message d'erreur puisque Xdebug est le nom d'une extension mais ce n'est pas 
le nom d'une classe reconnue par PHP. 

err_appel_xdebug.php 

<?php 

echo ' <pre>' ; 

Reflection : : export (new Ref lectionClass ( ' xdebug' ) ) ; 

echo '</pre>'; 

?> 

Ce qui a pour resultat l'affichage dans le navigateur du message suivant : 



Fntril Minn* TT n , : au^ht rr::-: «ri -ti- -ii 'F eO-r-: ti- ilE::-: -ri ti- u" with ine::;i^ ''i'la:: :: lrl u^ l- r: 
not exist' in C:W^pp\htdocs\dynainisez_^hp\chap08\php_manual\]istingl.php:2 Stack 
ti r #" '.' , ::;un| | 'Jit l- '::' lvii;um:'rzj li| '':li;i| l| :!: , | li| _iii;uiu;iJ , Jj;tui^l |hjO 

R.eflectionClass-> construct('xdebug') #1 {main} thrown in 

C:\xainppVhtdacs\^ F nainisez_php\chapOS\php_mainialVlistiiigl.php on line 2 

" I 

Fig. 8.2 : Erreur : Xdebug n'est pas programmee en POO. 

Vous voulez tester pour une autre classe ? Reprenez le script methode_export.php et 
modifiez la valeur de la variable $classname = 'Reflection 1 ; par $classname 
= 'ReflectionClass 1 ; et vous connaitrez toutes les fonctions de la classe 
ReflectionClassU que vous avez a votre disposition. Observez le script reflexion 
_sur_ReflectionClass.php : 

ref lexion_sur_Ref lectionClass. php 

<?php 

// Choisir une classe 
$classname = 'ReflectionClass'; 

echo ' <pre>' ; 

// Voici LA ligne qui affiche 

// toutes les informations de la classe 

Reflection : : export (new ReflectionClass ( $classname ) ) ; 

echo ' </pre>' ; 

?> 
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Class [ class ReflectionClass implements Reflector ] { 

- Constants [3] { 

Constant [ integer IS_IMPLICIT_ABSTRACT ] { 16 } 

Constant [ integer IS_EXPLICIT_ ABSTRACT ] { 32 } 

Constant [ integer IS FINAL ] { 64 } 



Fig. 8.3 : 

Un extra it de 
ReflectionClass par 
reflexion 



Static properties [0] { 



Static methods [1] { 

Method [ static public method export ] { 

- Parameters [2] { 

Parameter #0 [ ^argument ] 
Parameter #1 [ Sreturn ] 



Properties [1] { 

Property [ public $name ] 



Methods [40] { 

Method [ final private method clone ] { 



Method [ public method construct ] { 



Parameters [1] { 

Parameter #0 [ ^argument ] 



Method [ public method toString ] { 



Method [ public method getName ] { 



Method [ public method islnternal ] { 



Tlpr.hnd r rmTn 1 i <-. Tnpr.hnd i =! 



TT^prDpflnprt 1 



Quand vous executez le script dans votre navigateur, vous avez une description tres 
precise de ce que vous pouvez utiliser comme fonctions et comme attributs. Vous savez 
deja que la classe Refl ectionCl ass{ } possede trois constantes de type entier (int), une 
methode statique nommee export () (celle que vous avez utilisee dans le script precedent) 
et quarante methodes dont seules celles qui ont un acces public (publ i c) sont utilisables. 
Les methodes d'acces protege (protected) ne sont utilisables que pour les classes qui 
sont des classes etendues de la classe Refl ectionCl ass{ } et les methodes, comme la 

methode clone(), qui ont un acces prive (private) ne sont accessibles que par les 

methodes incluses dans la meme classe. Quant aux methodes construct () et 
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toString(), elles sont egalement appelees, en PHP, des methodes magiques et sont 

utilisees implicitement. Autrement dit, vous n'avez pas a vous en occuper. 

8.3 Tout conncntre d'une fonction 

Une fois la reflexion faite sur la classe, vous pouvez pousser l'experience encore plus 
avant en effectuant la reflexion sur chaque fonction de la classe. La classe qui s'en charge 
est ReflectionFunction{}. Et si vous effectuez une reflexion sur cette classe (script 
reflexion_sur_ReflectionFunction.php), un extrait du resultat est visible a la figure 
suivante : 

reflexion_sur_Ref lection Function, php 

<?php 

echo ' <pre>' ; 

Reflection: :export (new Ref lectionClass ( ' Ref lectionFunction' ) ) ; 

echo ' </pre>' ; 

?> 



Class [ class Ref lectionFunction extends Ref lectionFunctionAristract implements Reflector ] { 

- Constants [1] { 

Constant [ integer IS_DEPRECATED ] {2 62 144 } 

) 

- Static properties [0] { 

} 

- Static methods [1] { 

Method [ static public method export ] { 

- Parameters [2] { 

Parameter #0 [ Sname ] 

Fig. 8.4 : Un extrait de Reflection Function par reflexion 

La premiere ligne indique que la classe ReflectionFunction{} est une classe etendue de 
la classe ReflectionFunctionAbstract{} et qu'elle implemente aussi l'interface 
Reflectory }. Vous pouvez aussi voir dans les methodes statiques que la fonction 
export () s'y trouve a nouveau. Le script fonction_calculerSomme.php utilise la methode 
export() de la classe ReflectionFunction{} qui retourne sous forme de chaine tous les 
renseignements de la fonction cal cul erSomme () : 

fonction_calculerSomme.php 

<?php 
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// On definit une fonction toute simple 

J -k-k 

* Ici la description de la fonction qui sera 

* recuperable par getDocComment ( ) de la classe 

* Ref lectionFunction 
* 

* @param int $argl 

* dparam int $arg2 

* @return unknown 
*/ 

function calculerSomme (int $argl, int $arg2){ 
return $argl + $arg2; 

} 

echo ' <pre>' ; 
// LA ligne qui disseque 
echo Ref lectionFunction : 
echo ' </ pre>' ; 
?> 

Le resultat est visible sur la figure suivante. 



/** 

* Ici la description de la fonction qui sera 

* recuperable par getDocComment ( ) de la classe 

* Ref lectionFunction 

* Sparam int Sargl 

* Sparam int $arg2 

* @ return unknown 
V 

Function [ function calculerSomme ] { 

@@ C : \ Program Files\ xampp\ htdocs\ dynamise z_php\ chap08\ dissequer_f onct ion. php 1:3 - 15 

- Parameters [2] { 

Parameter #0 [ int Sargl ] 
Parameter #1 [ int Sarg2 ] 

} 

} 



Fig. 8.5 : Reflexion de la fonction calculerSomme 

Comme d' habitude, la premiere ligne donne le nom de la fonction. La deuxieme ligne 
donne le chemin complet et le nom du fichier dans lequel est definie la fonction. La 
deuxieme ligne donne egalement d'autres informations : le numero de ligne ou commence 
la fonction et le numero de ligne ou elle finit. Dans cet exemple, il est indique 13 - 15. 
Si vous analysez le script fonction_calculerSomme.php, il est aise de se rendre compte 
que la definition de la fonction commence a la treizieme ligne et se termine a la 
quinzieme ligne. 



la fonction 
: export (calculerSomme) ; 
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Voici les fonctions de la classe ReflectionFunction{} : 
chaTne getName() retourne le nom de la fonction. 

bool islnternal () retoume true si une fonction est interne a PHP ou false si elle 
l'a ete par le programmeur. 

bool i sUserDefi ned() effectue l'inverse de islnternal () et retourne true si une 
fonction a ete definie par le programmeur ou f al se si elle est interne a PHP 
chaTne getFileName() retourne le nom du fichier dans lequel se trouve la definition 
de la fonction. Si la fonction est interne a PHP, elle n'est done pas definie dans un 
fichier, getFi 1 eName() retourne une chaine vide. 

entier getStartLine() retourne le numero de ligne du debut de la definition de la 
fonction. 

entier getEndLineQ retourne la numero de ligne de la fin de la definition de la 
fonction. 

chaTne getDocComment() retourne le commentaire associe a la fonction a condition 
que celui-ci (le commentaire) soit formate de la facon suivante : 

/** 

* description de la fonction 

* @nom_predef ini 
*/ 

nom_predef i ni peut avoir pour valeur : author, copyright, name, param, etc. 

tableau getStaticVariables() retourne sous forme de tableau les variables 
statiques definies dans la fonction. 

entier getNumberOfParameters() retourne le nombre de parametres de la fonction 
(les variables situees entre les parentheses de la fonction placee en reflexion), 
entier getNumberOfRequiredParameters() retourne le nombre de parametres 
obligatoires lors de l'appel de la fonction. Si une fonction comporte trois parametres 
dont un optionnel alors getNumberOf Parameters () retournera la valeur 3 et 
getNumberOfRequiredParameters() retournera la valeur 2. 

Le script dissequer_function.php montre un exemple d'utilisation de chacune des 
fonctions que nous venons de decrire : 

dissequerjonction.php 

<?php 

// Utilisation des methodes de la classe Ref lectionFunction 
$F = new Ref lectionFunction (' printf ) ; 
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echo $F->isInternal ( ) 
? 'printf est une fonction interne a PHP' 
: 'printf est une fonction creee par un programmeur ' ; 

echo ' <br/>' ; 

/ * * 

* Ceci est une fonction qui n'est pas interne a PHP 

* @author David DRAPEAU 
* 

* @param int a 

* @param int b 

* @return int sum 
*/ 

function calculerSomme ($a, $b, $msg = 'la somme est ') { 

$c = $a + $b; 
return $msg . $c; 

} 

$nomFonction = 'calculerSomme'; 

$F = new Ref lectionFunction ($nomFonction) ; 

echo $F->isInternal ( ) 
? ' testFonction est une fonction interne a PHP' 
: 'testFonction a ete creee par un programmeur'; 

echo ' <br/>' ; 

// Restons toujours sur la fonction printf 

// 

// nom de la fonction 
$nom = $F->getName ( ) ; 

echo ' le nom de la fonction : '. $nom .'<br/>'; 

// nom du fichier dans lequel se trouve 
// la definition de la fonction 
$filename = $F->getFileName ( ) ; 

echo ' le nom du fichier ou est ecrite la fonction : ' . 
$filename .'<br/>'; 

// ligne de debut 

$ligneDeb = $F->getStartLine ( ) ; 

echo ' a quel endroit du fichier demarre 

la fonction : ligne ' . $ligneDeb .'<br/>'; 

// ligne de fin 
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$ligneFin = $F->getEndLine ( ) ; 

echo 'a quel endroit du fichier se termine 

la fonction : ligne ' . $ligneFin . '<br/>'; 

// les lignes de commentaires qui documentent la fonction 

$comment = $F->getDocComment ( ) ; 

echo 'commentaires sur la fonction :<br/>' ; 

echo ' <pre>' ; 

echo $comment; 

echo ' </pre>' ; 

// valeurs de retour 

$returns = $F->returnsRef erence ( ) ; 

echo $returns . '<br/>'; 

// parametres 

$param = $F->getParameters ( ) ; 
echo $param . '<br/>'; 

// nombre de parametres 

$nbParams = $F->getNumberOf Parameters () ; 
echo $nbParams . '<br/>'; 

// nombre de parametres requis 

$nbRqParams = $F->getNumberOf RequiredParameters ( ) ; 
echo $nbRqParams . '<br/>'; 

echo 'utilisation de export () <br/>' ; 
echo ' <pre>' ; 

Ref lectionFunction : : export ( ' calculerSomme' ) ; 
echo ' </pre>' ; 

?> 

8.4 ReflectionMethod : on entre dans la classe 

La difference entre la classe ReflectionFunction{ } et la classe Ref 1 ecti onMethod{ } est 
que la premiere concerne les fonctions ecrites hors de toutes classes alors que la seconde 
concerne les methodes defmies a l'interieur d'une classe. II semble done logique que les 
informations qu'il est possible d'y recuperer soient differentes. Par exemple, s'agissant 
d'une methode, vous pouvez recuperer le nom de la classe dans laquelle elle est defmie. 
C'est une information qu'il est impossible de connaitre d'une fonction puisque celle-ci 
n'appartient a aucune classe. Une autre evidence est qu'une methode est aussi une 
fonction dans le sens ou, tout comme une fonction, la methode possede un nom, est 
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definie par l'utilisateur ou est interne a PHP, etc. La classe Refl ectionMethod{ } possede 
done des methodes heritees de la classe ReflectionFunction{} qui sont les suivantes : 
getName(), islnternal (), isUserDefined(), getFileName(), getStartLi ne(), 
getEndLine(), getDocComment(), getStaticVariables(), returnsReference(), 
getParameters(), getNumberOf Parameters () , getNumberOf Requi red Parameters (). 

Parmi les nouvelles methodes, vous avez les suivantes : 

public construct (mi xte $nom_classe, chaTne $nom_methode) qui est 

automatiquement utilisee lors de l'instanciation de l'objet de la classe. 

public chaTne toString() et egalement une methode magique (comme 

construct ()) dont vous n'avez pas a vous preoccuper. Elle jouera son role le 

moment venu. 

public static chaTne export(mixte $nom_classe, chaTne $nom_methode, bool 
$retour). 

public mixte invoke(stdclass $object, mixte $args). 

public mixte invokeArgs(stdclass $objet, tableau $args). 

public bool isFinal () permet de verifier si une classe peut etre derivee ou non. 

publ ic bool isAbstract() verifie si une classe peut etre utilisee directement ou s'il 

faut passer par une autre classe qui en derive. 

public bool isPublic() determine si une methode possede un acces public, 
public bool isPrivate() determine si une methode possede un acces prive. 
public bool isProtected() determine si une methode possede un acces protege, 
publ ic bool isStatic() determine si une fonction peut etre redefinie (ou non) dans 
une classe qui en herite. 

public bool i sConstructor() retourne true si la methode est un constructeur et 
false sinon. 

publ i c bool i sDestructor () retourne true si la methode est un destructeur et f al se 
sinon. 

public entier getModifiers(). 

public Refl ecti onCl ass getDeclaringClass() cree une reflexion sur la classe dans 
laquelle la methode (sur laquelle vous faites la reflexion) est definie. 

8.5 Cas pratique : un systeme de plug-ins 

Vous venez d' avoir une idee geniale (et rentable) et vous desirez creer une application 
complete en PHP5. Vous avez pour objectif de faire evoluer le projet en ajoutant, dans un 
futur plus ou moins proche, de nouvelles fonctionnalites et ce, sans avoir a retourner dans 
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le code deja ecrit. Et quand cette fonctionnalite est en place, un lien sur la page d'accueil, 
sur laquelle vous n'avez rien modifie, affiche le lien comme par magie. Car, une chose est 
sure, quand vous n'avez pas touche au code d'un projet durant des mois, se replonger 
dedans, meme quand vous en etes le concepteur, n'est pas toujours aise quand le projet 
fait plusieurs dizaines (centaines ?) de milliers de lignes de codes et quelques centaines 
(milliers ?) de fichiers. Vous allez decouvrir dans ce cas pratique, grace a la reflexion, que 
vous pourrez ajouter de nouvelles fonctionnalites sans avoir a retoucher le code deja ecrit 
dans le projet. Et l'avantage, c'est que l'inverse est tout aussi vrai. Vous pourrez 
supprimer une fonctionnalite juste en supprimant les fichiers concernes sans avoir a 
modifier quoi que ce soit dans le reste du projet. Et mieux encore, si vous desirez garder 
les fichiers presents sur votre serveur, vous n'aurez qu'a placer le code du plug-in et de 
la fonctionnalite en commentaire. 

Dans les differentes methodes etudiees, il y en aura trois. L'exemple est montre pour une 
application web quelle qu'elle soit : site Internet, application intranet/extranet. II s'agit de 
partir d'un noyau en MVC (Model View Controller) qui sera le cceur du projet. Plus 
significativement, il s'agit de la partie du programme qui prendra en compte toutes les 
nouvelles fonctionnalites sans que rien ne soit modifie dans ce projet. II existe done en 
racine un fichier index.php qui appelle le controleur. Egalement en racine, il y a un 
repertoire models qui contient tous les fichiers nommes Model*. php et un repertoire views 
qui contient tous les fichiers nommes View*. php ou * represente le nom de Taction a 
effectuer (par exemple, si vous desirez ajouter un client, les fichiers a creer seront 
ModelAjouterClient.php et ViewAjouterClient.php). Evidemment, il est egalement 
necessaire de creer un repertoire include qui contient des classes dont les fichiers sont 
nommes Class*. php. Puis, vient le repertoire le plus important, toujours en racine, qui est 
le fameux (indispensable !) repertoire nomme plug-ins dans lequel vous allez placer des 
modules, vos fameux plug-ins qui seront nommes *.php, qui ne sont ni des modeles, ni 
des vues mais des fonctionnalites automatiquement recuperees par le projet et rendront 
ainsi actifs les modeles et les vues des que le fichier .php sera ajoute dans le repertoire 
plug-ins (en gardant le meme exemple, pour que la fonctionnalite ajouter un cl ient soit 
prise en compte, vous ajouterez le fichier AjouterClient.php). En clair, toute la partie 
MVC est le noyau qui va recuperer les plug-ins arm de permettre a 1' application de 
recuperer les fonctionnalites au fur et a mesure que celles-ci sont installees. 

Premiere methode : la plus simple pour comprendre 

Dans le projet, vous decidez de consacrer une petite partie de la page d'accueil a 
l'affichage de liens vers des sites Internet distants, ce qui pourrait etre par exemple vos 
sites favoris, ceux que vous frequentez le plus. Probablement qu'au commencement du 
projet, il n'y aura aucun lien. Ce n'est pas la priorite du site. Done, il ne faut pas de 
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messages d'erreurs si le repertoire plug-ins ne contient aucun fichier et en meme temps 
il faut prevoir le fait qu'il en possedera bientot arm de ne pas avoir a revenir dans le code 
du noyau ulterieurement excepte pour optimiser celui-ci. 

index_methodel .php 

<?php 

$dir = opendir ('. /plug-ins' ) ; // On scanne le repertoire 

// On scanne le repertoire plug-ins 
while (($file = readdir ($dir) ) !== false) { 

//Si le nom du fichier est different de . et de .. 
if($file != '.' && $file != '..'){ 
// on appelle le fichier 
require once ( ' plug- ins/ ' . $f ile) ; 

/ / Puis on separe le nom du fichier de son extension 
// afin de recuperer le nom de la classe 
// se trouvant dans le fichier 

list ( $className, $extensionFile) = explode (".", $file) ; 

// On appelle la classe qui se trouve dans le fichier 
$oRC = new Ref lectionClass ($className) ; 

// On verifie que la classe possede bien 
// la methode ' a j outerLien ( ) ' 
$oRC->hasMethod('ajouterLien' ) 
? $lien = 'true' : $lien = 'false'; 

if($lien == 'true' ) { // Si c'est le cas 
$oCN = new $className; 

// On ajoute le lien dans la page web 
// en fonction des informations 
/ / recuperees dans la classe 
// par les proprietes de classe 
echo '<a href ="' . $oCN->leLien . "' />' . 
$oCN->laDescriptionDuLien .'</axbr/>' ; 

} 

} 

} 

closedir ( $dir ) ; 
?> 
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Tel que programme dans cet exemple, il est primordial que le nom de la classe soit 
identique au nom du fichier. Voici la definition de la classe Micro Applications. php a 
inserer dans le repertoire plug-ins qui permet d'ajouter dans la page d'accueil de 
1' application un lien externe (a 1' application) qui pointe vers le site Internet de 
Micro Application : 

MicroApplications.php 

<?php 
/** 

* Cette classe est en fait un plug-in 

* IMPORTANT : II est PRIMORDIAL que le nom de la classe 

* soit identique au nom du fichier sans 1' extension .php 

* et en respectant la meme casse 

* Cette classe est appelee par un fichier qui 

* utilise la methode de reflexion pour recuperer 

* les informations necessaires 

*/ 

class MicroApplications { 

public $leLien = 'http://www.microapp.com/'; 
public $laDescriptionDuLien = 'MicroApplications'; 

public function construct (){ } 

public function destruct(){} 

public function a j outerLien ( ) { } 

} 

?> 

Ce premier exemple est une solution mais elle n'est pas tres efficace. Imaginez le nombre 
de fois que vous allez appeler la fonction requi re_once() dans la boucle si vous avez 
pres d'une centaine de plug-ins d'installes. La quantite de ressources consommee serait 
tres grande et le temps d'affichage de la page s'en trouverait nettement augmente. 
Pourquoi cet exemple alors ? Pour vous rappeler que la premiere bonne solution trouvee 
n'est pas forcement la meilleure. Elle est certainement valable puisque cela fonctionne et 
appelle bien les bons plug-ins. Cependant, elle est loin d'etre la meilleure. Voyez tout de 
suite la deuxieme methode. 
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Deuxieme methode : visez I'efficacite 

Dans l'exemple qui suit, des que le script trouve un fichier, il utilise la fonction expl ode() 
afin de separer dans le nom du fichier Taction a effectuer du nom de la classe qui decrit 
precisement ce que va faire le fichier. Et c'est ce prefixe qui va dire quelle est Taction que 
va effectuer le plug-in : ajouter un lien externe, un lien interne, manipuler des donnees 
SQL, et/ou toute autre manipulation que vous aurez definie dans votre projet. Si le nom 
du prefixe correspond a Taction ajouterLien, alors on execute Taction qui va ajouter 
dans la partie de la page le lien qui va pointer vers le site Internet distant. Voici le script 
qui appelle les plug-ins concernes : 

index_methode2.php 

<?php 

$f ile = " ; 

$dir = opendir ('. /plug-ins' ) ; // On scanne le repertoire 

// On scanne les repertoires 

while (($file = readdir ($dir) ) ! == false) { 

//Si le nom du fichier est different de . et de .. 
if($file != '.' && $file != '..'){ 

// On decompose le nom de fichier pour connaitre 1' action a 
effectuer 

list ( $action , $filename) = explode ("_-_" , $file); 
//echo $action .'<br/>'; 
if($action == ' aj outerLien' ) { 

require once (' plug-ins/ ' . $file); 

// Puis on separe le nom du fichier de son extension 
/ / afin de recuperer le nom de la classe se trouvant dans le 
fichier 

list ( $className, $extensionFile ) = explode (".", $filename) ; 

// On appelle la classe qui se trouve dans le fichier 
$oRC = new Ref lectionClass ( $className ) ; 

$oCN = new $className; 

// On ajoute le lien dans la page web 
/ / grace a la methode invoke ( ) 

$method = new Ref lectionMethod ($className, 'ajouterLien'); 
echo $method->invoke ($oCN, 'ajouterLien', true) ; 

} 

} 

} 
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closedir ( $dir ) ; 
?> 

Pour que ce script fonctionne, il faut que le fichier place dans le repertoire plug-ins 
respecte une norme de nom qui est action_-_nomclasse.php (exemple : 
ajouterLien_-_MicroApplications.php). Voici le fichier ajouterLien_-_MicroApplications 
.php qui contient la classe qui va ajouter dans la page web le lien qui pointera vers le site 
distant Micro Application : 

ajouterLien_-_MicroApplications.php 

<?php 

class MicroApplications { 

public $leLien = 'http://www.microapp.com/'; 
public $laDescriptionDuLien = 'Micro Applications'; 

public function construct (){ } 

public function destruct(){} 

public function a j outerLien ( ) { 

return ' <a href="'. $this->leLien .'" />' . 
$this->laDescriptionDuLien . '</a>' ; 

} 

} 

?> 

Les autres methodes 

En fait, vous avez le choix entre creer un fichier par lien ou placer tous les liens dans une 
table avec pour cle l'adresse Internet et pour valeur la description du lien que vous 
recupererez grace a la methode ajouterLi en () dans laquelle vous ecrivez les instructions. 
L'avantage de cette methode est que vous n'ouvrez qu'un seul fichier, ce qui rend la 
procedure beaucoup plus rapide. Seul inconvenient, quand vous desirez ajouter un lien 
supplementaire, vous devez retourner dans le code du fichier place dans le repertoire 
plug-ins. 

II existe bien d' autres methodes pour creer des systemes de plug-ins. II vous revient 
d'optimiser cet exemple, voire de le traiter de facon completement differente. Les deux 
methodes que nous vous avons presentees n'utilisent pas les bases de donnees. Cela peut 
etre une solution pourtant bien efficace si les tables SQL sont bien pensees. Vous pouvez 
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egalement melanger tout un ensemble de techniques comme la reflexion avec le codage 
dynamique via Runkit et des interfaces graphiques via XSLT. Cela permet de mettre deux 
equipes sur un gros projet : l'une se consacrera aux interfaces graphiques et l'autre a 
revolution de la programmation des fonctionnalites supplementaires a venir dans le 
projet via le systeme de plug-ins qui recupere egalement les fichiers XSLT pour 
l'affichage des donnees et ce, sans qu'aucune des deux equipes influe negativement sur 
l'autre. Et ce qui fonctionne pour deux equipes peut fonctionner pour trois ou plus. 
Developper cette idee necessiterait un ouvrage a part probablement bien plus volumineux 
que celui-ci. Un jour peut-etre... 

8.6 Check-list 

Dans ce chapitre, nous avons vu : 
>/ ce qu'est la reflexion ; 

s/ comment sont constitutes l'API de reflexion et les classes qui la composent ; 

comment analyser du code avec les differentes classes de l'API de reflexion ; 
s/ les differentes classes disponibles avec l'API de reflexion ; 
«/ comment creer un systeme de plug-ins via l'API de reflexion. 
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Soulager 
le serveur 
avec le cache 

A PC, pour Alternative PHP Cache (Cache PHP 
alternatif), va nous permettre d'alleger 
considerablement les taches du serveur en conservant en 
memoire (cache) differentes variables, ce qui nous 
permettra de stacker les resultats des requetes SQL. Le 
serveur n'aura done pas d effectuer ces requetes et se 
contentera de generer la page. Bref, e'est un gain de 
temps (et de puissance) considerable. 



Soulager le serveur avec le cache 



9.1 APC, tout simplement 

Afin d'entrer en contact avec APC, nous allons rediger un petit script qui stockera une 
variable dans le cache, qui l'afnchera, puis l'effacera. 

Dans un dossier nomme chap09, creez le fichier apcjtest.php et remplissez-le comme 
suit : 

&q apc_test.php 

<?php 

$maVariable = ' coucou' ; 
echo "maVariable : "; 

echo (apc_f etch (' ma Variable' )); //n' ecris rien car 

//la variable n'est pas encore stockee. 
echo "<br/>"; 

apc_add (' maVariable' , $maVariable ) ; //stocke la variable 
echo "maVariable : "; 

echo (apc_fetch (' maVariable' )); //ecris le contenu 
/ / de la variable 

apc_clear_cache ( "user" );//vide le cache 

echo "<br/>"; 

echo "maVariable : "; 

echo(apc f etch (' maVariable' )); //n' ecris rien car 
//la variable a ete effacee du cache. 

?> 



* Mozilla Firefox 



Fichier Edition Affichage Historique Marque-pages Outils ? 

<^1 - lIj ' U ntt P ; // |i:ii:alni:isl: / d y riamisez%2i:iPHp / i:na P | 

maVariable : 
maVariable : coucou 
maVariable : 



Fig. 9.1 : 

Seule b variable qui 
existe est affichee. 
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Dans ce premier exemple, nous utilisons trois fonctions : apc_fetch(), apc_add() et 
apc_clear_cache(). II s'agit la des trois fonctions les plus utilisees lorsque Ton travaille 
avec APC. Leur fonctionnement precis sera detaille dans la suite de ce chapitre. Pour le 
moment, nous allons ameliorer le fonctionnement du systeme de cache. 

En effet, dans notre court exemple, nous effacons immediatement la variable stockee dans 
le cache. Que se passe-t-il si nous supprimons de notre code l'appel a la fonction 
apc_cl ear_cache() ? 

Fig. 9.2 : 

Seul le premier appel 
(fonction apc_fetch()) ne 
renvoie rien. 



f OHozillaFirefox 


Fichier Edition Affichage 


Historique Marque-pages Outils ? 


-@ ■_ 




l5J | Dl http://localhost/dynamisez%20PHP/chap( 




maVanable : 




maVanable : coucou 




maVanable : coucou 





Comme prevu, le premier appel de la fonction apc_fetch ()ne renvoie rien, la variable 
$maVari abl e n'etant pas encore stockee dans le cache. Mais maintenant, cette variable 
restera stockee dans le cache indefiniment. Chargez une nouvelle fois cette page. 



Mozilla Firefox 



Fichier Edition Affichage Historique Marque-pages Outils ? 



f^f | □ http:/ /localhQst/dynamisez%20PHP/chap[ 



maVanable : 
maVanable : 
maVanable : 



Fig. 9.3 : 

Seul le premier appel 
affiche quelque chose. 



Le premier appel a apc_fetch() affiche bien le contenu de notre variable, mais qu'en est-il 
des deux autres appels ? Pourquoi n'affichent-ils rien ? 
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En fait, la fonction apc_add ()met une variable en cache uniquement si celle-ci n'est pas 
deja stockee. Dans le cas ou cette variable existerait deja dans le cache, la fonction 
retourne false. La variable n'est pas supprimee mais, a 1' utilisation, cela revient 
pratiquement au meme. Remplacons done la fonction apc_add()par la fonction 
apc_store() comme suit : 

ape store (' maVariable' , $maVariable );/ /stock la variable 
Et voila, le tour est joue ! 

Un systeme de cache evolue 

Dans 1' introduction de ce chapitre, nous avons pris l'exemple d'un forum. C'est 
exactement ce que nous allons faire maintenant afin de penetrer plus avant dans 
l'utilisation d'APC. Nous n'allons pas, bien evidemment, en creer un entierement, nous 
allons seulement nous interesser a la generation des pages. 

Pour ce faire, nous allons creer une base de donnees, que nous appellerons forum, et n'y 
ajouter qu'une seule table (nommee fil) que voici : 

CREATE TABLE 'forum', 'fil' ( 

' id' INT NOT NULL AUTO_INCREMENT PRIMARY KEY , 

'message' TEXT NOT NULL 

) 

Voici maintenant, d'un bloc, le fichier apc_forum.php, que nous allons modifier petit a 
petit tout au long de ce chapitre : 

apc_forum.php 

<?php 

$tempsDebut = microtime ( true ) ; 
// Parametres mysql a remplacer 

define (' DB_SERVER' , ' localhost' ) ; // serveur mysql 
define (' DB_SERVER_USERNAME' , 'root'); // nom d' utilisateur 
define (' DB_SERVER_PASSWORD' , " ) ; // mot de passe 
define (' DB_DATABASE' , 'forum'); // nom de la base 

$connect = mysql connect (DB SERVER, 

DB_SERVER_USERNAME, 

DB_S ERVER_PAS SWORD ) 
or die (' Impossible de se connecter : ' . mysql error ()); 
mysql_select_db (DB_DATABASE, $connect) ; 
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if ($_GET [' action' ] == "ajouter"){ 

$sql = "INSERT INTO 'f orum' . 'f il' ('id', 'message')"; 
$sql .= "VALUES (NULL , '". $_POST [' mes sage ']."')" ; 

if ( ! mysql_query ( $ sql ) ) { 

echo "le message n' a pas ete ajoute..."; 

} 

} 

af f icheFil ( ) ; 

af f icheFormulaire ( ) ; 

function piedHTML ( ) { 

echo "\n</body>\n</html>" ; 

} 

function aff icheFil () { 

$sql = "SELECT * FROM 'fil' "; 

$resultat = mysql_query ( $sql ) ; 

if (!$resultat) { 

echo "La requete a echoue."; 

} else { 

af f icheMessage ($resultat) ; 

} 



function aff icheMessage ( $r ) { 
$resultat = "<table>"; 

while ($line = mysql_fetch_assoc ($r) ) { 
$resultat .= "<tr>" ; 
foreach ($line as $col_value) { 

$resultat .= "<td>$col_value</td>" ; 

} 

$resultat .= "</tr>"; 

} 

$resultat .= "</table>"; 

echo utf 8_decode ($resultat) ; 



function aff icheFormulaire () { 

echo '<form method="post " action="apc forum . php?action=aj outer ">' ; 
echo '<textarea name="message" rows="5" cols=" 4 "></textarea>' ; 
echo '<input type=" submit" value="Aj outer " />' ; 
echo '</form>'; 
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} 

$tempsFin = microtime ( true ) ; 
$temps = $tempsFin - $tempsDebut ; 

echo utf 8_decode ( "duree de l'execution : ".$temps." secondes"); 
?> 



Comme vous pouvez le constater, ce fichier n'est pas un modele de programmation pour 
la communication avec mySQL, mais ce n'est pas le but ni de ce chapitre ni de cet 
ouvrage. 

► Fig. 9.4 : 

Un minuscule extrait d'un 
petit forum 



Fichier Edition Affichage Historique Marque-pages Outils ? 

^ l_J http://localhosl:/dynarnisez%20PHP/chap( 



Qj http://localhos...9/apc_forum.php Q [ ML l QI=a lhost / localhost / forum 



1 le premier message du forum 

2 un deuxieme message ! ! ! ! 

3 un troisieme message 

4 Et encore un autre message 




duree de l'execution : 0.00322S90281677 secondes 



Notez la presence d'un chronometre qui va nous permettre d'evaluer APC. 

Creons maintenant un autre fichier que nous appellerons apcjemoin.php, puis copions-y 
le contenu du fichier apc_forum.php. De cette maniere, nous pourrons toujours comparer 
les performances du fichier apc_forum.php, que nous modifierons en utilisant avec APC, 
celles du fichier apc_temoin.php. 

Mettre des reponses a des requetes SQL dans le cache 

La premiere modification que nous allons effectuer concerne le resultat de la requete 
SQL. Avant d'appeler la fonction afficheFi 1 (), la fonction qui execute la requete SQL, 
notre fichier se doit de verifier qu'il n'y a pas deja un resultat dans le cache. Modifions-le 
done ainsi : 
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if (apc_f etch (' stock' ) != 'en stock' ) { 

af f icheFil ( ) ; 
} else { 

$html = apc_f etch ( ' resultat' ) ; 

echo utf 8_decode ( $html ) ; 

} 

af f icheFormulaire ( ) ; 



Grace a la fonction apc_fetch(), notre programme commence par regarder si la variable 
de cache stock existe. II faut maintenant que notre fichier cree dans le cache contienne 
le resultat de la requete SQL. Nous allons done rajouter quelques lignes a notre fonction 
afficheMessage() : 



function af f icheMessage ( $r ) { 
$resultat = "<table>"; 

while ($line = mysql_fetch_assoc ($r) ) { 
$resultat .= "<tr>" ; 
foreach ($line as $col_value) { 

$resultat .= "<td>$col_value</td>" ; 

} 

$resultat .= "</tr>"; 

} 

$resultat .= "</table>"; 
echo utf 8_decode ($resultat) ; 

apc_store (' resultat' , $resultat ) ; // stocke la variable 
apc_store (' stock' , 'en stock'); 



La fonction apc_store() stocke nos deux variables de cache resul tat et stock. Cela fait, 
notre programme stocke la reponse de la requete SQL dans le cache, et ne l'executera 
plus. Nous remarquons pourtant que, meme lorsque notre programme ne fait pas de 
requete, il se connecte quand meme a la base de donnees. Nous regions done ce leger 
probleme comme suit : 

// Parametres mysql a remplacer 

define (' DB_SERVER' , ' localhost' ) ; // serveur mysql 
define (' DB_SERVER_USERNAME' , 'root'); // nom d' utilisateur 
define (' DB_SERVER_PASSWORD' , "); // mot de passe 
define (' DB_DATABASE' , 'forum'); // nom de la base 
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if ($_GET['action' ] == "ajouter"){ 
connexion ( ) ; 

$sql = "INSERT INTO 'forum'.'f il' ('id', 'message')"; 
$sql .= "VALUES (NULL , '". $_POST [' message' ]."')" ; 

if ( ! mysql_query ( $ sql ) ) { 

echo "le message n' a pas ete ajoute..."; 

} 

} 

if ( apc_f etch (' stock' ) != 'en stock' ) { 

af f icheFil ( ) ; 
} else { 

$html = apc_f etch ( ' resultat' ) ; 

echo utf 8_decode ($html) ; 

} 



function connexion () { 

$connect = mysql connect (DB SERVER, 

DB_SERVER_USERNAME, 

DB_S ERVER_PAS SWORD ) 
or die (' Impossible de se connecter : ' . mysql error ()); 
mysql_select_db (DB_DATABASE, $connect) ; 
} 

Essayons maintenant, grace a apc_forum(), de rajouter un message a notre fil de 
discussion. Comme vous pouvez le verifier, notre nouvelle entree n'apparait pas dans 
notre mini-forum. Pourtant, notre nouveau message a correctement ete enregistre dans la 
base de donnees... C'est normal. Notre variable etant deja dans le cache, la requete SQL 
n'est pas effectuee. Nous avons plusieurs alternatives pour regler ce probleme. 

Nous pouvons par exemple vider le cache au moment de la requete SQL 
d'enregistrement, grace a la fonction apc_cl ear_cache() : 

if ($_GET['action' ] == "ajouter"){ 
connexion ( ) ; 

$sql = "INSERT INTO 'forum'.'f il' ('id', 'message')"; 
$sql .= "VALUES (NULL , '". $_POST [' message ']."')" ; 

if ( ! mysql_query ( $ sql ) ) { 

echo "le message n' a pas ete ajoute..."; 

} 

apc_clear_cache ( "user" );//vide le cache 
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} 



Ou alors, nous pouvons ajouter un troisieme argument a la fonction apc_store() : 

function af f icheMessage ( $r ) { 
$resultat = "<table>"; 

while ($line = mysql_f etch_assoc ($r) ) { 
$resultat .= "<tr>" ; 
foreach ($line as $col_value) { 

$resultat .= "<td>$col_value</td>" ; 

} 

$resultat .= "</tr>"; 

} 

$resultat .= "</table>"; 
echo ut f 8_decode ( $resultat ) ; 

apcstore ( ' resultat' , $resultat, 5);//stocke la variable 
apc_store (' stock' , 'en stock', 5); 

} 

En procedant de cette maniere, les variables de cache resultat et stock seront effacees 
au bout de cinq secondes (ou plutot au moment de la requete suivante, si celle-ci apparait 
apres cinq secondes). Ce troisieme argument peut aussi etre ajoute a la fonction 
apc_add(). 

APC et les constantes 

Au tout debut de notre fichier apc_forum.php, nous definissons un certain nombre de 
constantes que nous utilisons pour la connexion a la base de donnees. II n'est cependant 
pas judicieux de les redefinir a chaque chargement de notre programme. 

APC permet la mise en cache des constantes et est meme un peu plus rapide que 
define (). Nous allons done modifier notre code arm qu'il integre cette fonctionnalite. 
Modifiez-donc apc_forum.php de la maniere suivante : 

if ( ! apc_load_constants (' constantes' ) ) { 
// Parametres mysql a remplacer 

$constantes = array ( 

'DB_SERVER' => 'localhost', 

' DB_SERVER_USERNAME' => 'root', 

' DB SERVER PASSWORD' => " , 
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' DB_DATABASE' , 'forum' 

) ; 

apc_def ine_constants ( ' constantes' , $constantes) ; 

} 

if ( apc_f etch (' stock' ) != 'en stock' ) { 

En passant un tableau contenant toutes les constantes et une cle d' indexation a la fonction 
apc_define_constants() , nous les stockons dans le cache. Pour les appeler depuis le 
cache, nous utilisons simplement la fonction apc_load_content()... 

Voyez maintenant la difference de performance entre les fichiers apcjtemoin.php et 
ape _forum.php . 



3 Mozilla Firefox 



Fichier Edition Affichage Historique Marque-pages Outils ? 

T @ iS | D http://l ocalhost/dynamisez%20PHP/chap< 

^ monok f' ex 3 reference Lk^ Animeka 

' Q http://localhost/d...ap09/apc_forum.php £jj f Q http://localhos.../apc_t( 

1 le premier message du forum 

2 un deuxieme message ! ! ! ! 

:■ Uli tl--i;irlli'r Uir:::v2<: 

4 Et encore un autre message 

5 coucou ! je suis ici ! 

6 youpi tralala 

7 encore un message qui ne dit nen 

8 Grunt ! 

9 

10 il n'y a nen dans le message nurnero 9 ! ! ! 

1 1 un onzieme message... 

12 J'aime bien rajouter des messages qui ne veulent nen dire... 

13 Oooooh yeah ! 

14 message 



[ Ajouter ~] 

duree de 1' execution : 0.00328302383423 secondes 



Fig. 9.5 : 

Le fichier 

apcjemoin.php met un 
certain temps a 
s'afficher. 
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Mozilla Firefox 



Fichier Edition Affichage Historique Marque-pages Outils 



hfcfcp://localhost/dynamisez%20PHP/chapi 



Si monok flex 3 reference Ll t Animeka 



[ Q| http://localhos...q/apc_forum.php Q | Qj http://localhost/d...p09/apc_ 



1 le premier message du forum 

2 un deuxieme message ! ! ! ! 

3 un troisieme message 

4 Et encore un autre message 

5 coucou ! je suis ici ! 

6 youpi tralala 

7 encore un message qui ne dit nen 

8 Grunt ! 

9 

10 iln'y a nen dans le message nurnero 9 ! ! ! 

1 1 un onzieme message... 

12 J'aime bien rajouter des messages qui ne veulent nen dire.. 

13 Oooooh yeah ! 

14 message 




duree de l'execution : 7.79628753662E-5 secondes 



Fig. 9.6 : 

Le fichier apc_forum.php 
que nous avons modifie 
est beaucoup plus 
rapide, meme avec 
seulement 14 messages. 



9.2 Check-list 

Apres avoir lu ce chapitre, utiliser le cache avec APC est devenu chose aisee. 
Nous avons vu : 

comment charger des variables en memoire cache grace aux fonctions apc_add() et 
apc_store() ; 

>/ comment acceder a des variables disponibles en memoire cache ; 
</ comment enregistrer et lire des constantes depuis la memoire cache. 
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10.1 Creer du bytecode 
1 0.2 Lire le bytecode . . 
10.3 Check-list 



274 
282 
285 




le code PHP 



B compiler permet de compiler votre code PHP. Mais d 
quoi cela sert-il ? Tout simplement d proteger vos lignes 
de code si durement creees d la sueur de votre front. En 
effet, les fichiers compiles par Bcompiler sont illisibles pour 
un etre humain, mais parfaitement utilisables par un 
ordinateur. Vous pouvez ainsi diffuser vos fichiers PHP 
compiles sans craindre pour leur integrite. 



lO Compiler le code PHP 



1 0. 1 Creer du bytecode 
Compiler un fichier 

Afin de s'initier a Bcompiler, nous allons commencer par le plus simple : la compilation 
d'un fichier PHP complet. 

Dans un dossier intitule chaplO, nous allons creer un dossier bytecode ainsi que les 
fichiers bcompiler Jichier.php et bcompiler _fichier _proprietaire.php. 

Voici le contenu de bcompiler ^fichier _proprietaire.php : 
bcompiler_fichier_proprietaire.php 

<?php 

$secret = "mot de passe hyper secret"; 

echo "mon fichier PHP<br/>\n" ; 

?> 

Si Ton invoque ce fichier via la commande include, la phrase "mon fichier PHP" 
apparaitra simplement a l'ecran. 

Le second fichier, bcompiler Jichier.php va seulement nous servir a compiler le fichier 
bcompiler ^fichier _proprietaire.php, puis a afficher son contenu : 

bcompiler_fichier.php 

<?php 

// adresse du futur fichier compile : 

$bytecode = "bytecode/bcompiler fichier proprietaire . phb" ; 
// adresse du code source : 

$codeSource = "bcompiler fichier proprietaire . php" ; 

// creation du fichier compile : 

$f ichierBytecode = f open ($bytecode, "w"); 

// ecriture de l'en-tete du fichier : 
bcompiler write header ( $f ichierBytecode) ; 

//ecriture du corps du fichier : 

bcompiler write file ($f ichierBytecode, $codeSource) ; 

// ecriture du pied de page du fichier : 
bcompiler write footer ( $f ichierBytecode) ; 
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/ / fermeture du fichier : 
fclose ( $f ichierBytecode ) ; 

// appel du fichier compile : 

include ' bytecode/bcompiler fichier proprietaire . phb' 
?> 



Lorsque vous lancez ce fichier, la phrase "mon fichier PHP" apparait comme convenu a 
l'ecran : le fichier de bytecode a bien ete cree. Vous pouvez remarquer 1' extension de ce 
nouveau fichier : .phb, comme "PHp Bcompiler" ; mais il ne s'agit la que d'une 
convention. Nous aurions pu choisir n'importe quelle autre. 

Les etapes pour creer un fichier de bytecode sont assez simples. D'abord, nous creons le 
fichier lui-meme, via la fonction fopen()Ensuite, nous ecrivons le contenu du fichier via 
les fonctions bcompi 1 er_wri te_header() , bcompiler_write_file() et bcompiler_write 
_footer(). Nous en deduisons done qu'un fichier de bytecode, comme n'importe quel 
fichier, dispose d'un en-tete, d'un corps et d'un pied de page. 

Attardons-nous un peu sur ce fichier de bytecode : ouvrons-le avec un editeur de texte, tel 
que Notepad. Que voyons-nous ? Des carres et des espaces a foison. Ainsi, notre code est 
protege. Et pourtant... Si nous regardons un peu plus attentivement, nous voyons tres 
lisiblement ecrite la chaine de caracteres "mon fichier PHP", ainsi que le contenu de la 
variable $secret. C'est tout a fait normal : une chaine de caracteres n'etant pas, a 
proprement parler, du code, il serait absurde de tenter de la compiler. . . II ne faut done pas 
laisser de donnees sensibles, comme un mot de passe, par exemple, dans un fichier de 
bytecode, a moins de les crypter au prealable. 

Comparons maintenant le poids du fichier de bytecode et celui du fichier source : 
^ , Fig. 10.1 : 

^ bcompilerJichier_proprietaire.... " Notre fichier SOUTCe 

Fichier PHP 
1 Ko 



bcornpiler_f ichier_proprietaire . php 
Type : Fichier PHP 

Date de modification : 25/08/2007 19:10 
Taille : 81 octets 
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\ bcornpiler_fichier_proprietaire.. 
Fichier PHB 
1 Ko 



bcornpiler_flchier_proprietaire , phb 
Type : Fichier PHB 

Date de modification : 25/08/2007 19:09 
Taille : 412 octets 



Fig. 10.2: 

Notre fichier compile 
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Vous vous rendez compte que le fichier de bytecode pese environ cinq fois plus lourd que 
le fichier source ! C'est helas le prix a payer pour proteger ses algorithmes. 

Test de vitesse 

Nous allons maintenant comparer la vitesse d' execution d'un fichier de bytecode et du 
fichier source. Pour ce faire, nous allons creer trois flchiers : bcompiler_vitesse.php, 
bcompiler_vitesse_ouvert.php et bcompiler_vitesse_secret.php. 

bcompiler_vitesse_ouvert.php 

<?php 

function ouvert () { 

for($i = ; $i < 100000 ; $i++) { 
$a = $i." : " . sqrt ($i*5) . "<br/>\n"; 

} 

} 

?> 

Ce fichier ne contient qu'une seule fonction dont le but avoue est de faire travailler le 
processeur un certain temps. 



bcompiler_vitesse_secret.php 

<?php 

function secret (){ 

for($i = ; $i < 100000 ; $i++) { 
$a = $i." : " . sqrt ($i*5) . "<br/>\n"; 

} 

} 

?> 

Le fichier bcompiler_vitesse_secret.php a exactement le meme but que le fichier 
bcompiler_vitesse_ouvert.php, a ceci pres qu'il va etre compile. 

Enfin, voici le code du troisieme fichier (bcompiler_vitesse.php) : 



J^jt bcompiler_vitesse.php 



<?php 






// adresse 


du futur fichier compile : 




$bytecode = 


"bytecode/bcompiler fonctions 


secret . phb" ; 


/ / adresse 


du code source : 




$codeSource 


= "bcompiler fonctions secret 


php" ; 
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// creation du fichier compile : 

$f ichierBytecode = f open ( $bytecode, "w" ) ; 

// ecriture de l'en-tete du fichier : 
bcompiler write header ($f ichierBytecode) ; 

//ecriture du corps du fichier : 

bcompiler write file ($f ichierBytecode, $codeSource) ; 

// ecriture du pied de page du fichier : 
bcompiler write footer ($f ichierBytecode) ; 
fclose ( $f ichierBytecode) ; 

echo "poids avant compilation : <b>" . f ilesize ( $codeSource ) ." 
octets</bxbr/>" ; 

include 'bcompiler fonctions ouvert . php' ; 

include ' bytecode/bcompiler_f onctions secret .phb' ; 

$tempsDebut = microtime ( true ) ; 
ouvert ( ) ; 

$tempsFin = microtime (true ) ; 
$temps = $tempsFin - $tempsDebut; 

echo "Nous avons mis <b>$temps</b> secondes avec le code 
source .<br/>\n" ; 

echo "poids apres compilation : <b>" . f ilesize ( $bytecode ). " 
octets</b>.<br/>" ; 

$tempsDebut = microtime ( true ) ; 
secret ( ) ; 

$tempsFin = microtime (true) ; 
$temps = $tempsFin - $tempsDebut; 

echo "Nous avons mis <b>$temps</b> secondes avec le bytecode . <br/>\n" ; 
?> 

Ce dernier fichier va compiler bcompiler_vitesse_secret.php, puis executer les deux 
fonctions et comparer les vitesses d' execution de l'une et de 1' autre, ainsi que le poids du 
fichier source et du fichier de bytecode. 

Voici les resultats obtenus lorsque nous lancons ce script depuis la machine sur laquelle 
nous ecrivons : 
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Fig. 10.3: 

Resultat du script 



' ' @ ® * | D http://127,0,0,l/dynamisez% 



poid avant compilation : 111 octets 

Nous avons mis 0.340789794922 secondes avec le code source, 
poid apres compilation : 1228 octets. 

Nous avons mis 0.333310842514 secondes avec le bytecode. 



Nous pouvons voir qu'un fichier de bytecode n'est pas execute plus rapidement que s'il 
n'avait pas ete compile. 

Compiler des classes et des fonctions 
Les fonctions 

Bcompiler, en plus de permettre la compilation complete d'un fichier, permet de n'en 
compiler que certaines fonctions. Cela est tres pratique pour obtenir un fichier compile 
contenant quelques utilitaires. 

Nous allons done, toujours dans notre dossier chaplO, creer deux nouveaux fichiers. Le 
premier, bcompiler_fonction_source.php, contiendra le code source de quelques fonctions 
et les compilera. Le second, bcompiler _fonction.php, nous servira a tester le fichier de 
bytecode genere par le premier fichier. 

Voici le code de notre premier fichier : 
<^ bcompiler_fonction_source.php 



// adresse du futur fichier compile : 
$bytecode = "bytecode/bcompiler_f onction .phb" ; 

// Creation du fichier compile 

$f ichierBytecode = f open ( $bytecode, "w" ) ; 

// ecriture de l'en-tete du fichier : 
bcompiler write header ( $f ichierBytecode) ; 

// ecriture des fonctions au sein du fichier compile 
bcompiler write function ( $f ichierBytecode, "phraseEnCouleur " ) ; 
bcompiler_write function ( $f ichierBytecode, "aj outPhrase" ) ; 
bcompiler_write function ( $f ichierBytecode, "ecritPhrase" ) ; 



<?php 
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// ecriture du pied de page du fichier : 
bcompiler write footer ($f ichierBytecode) ; 
fclose ( $f ichierBytecode ) ; 

// les fonctions a compiler : 

function phraseEnCouleur ( $phrase = "Phrase par defaut", 

$couleur = "#DE0059") { 
return ' <div style="color :'. $couleur .'">'. $phrase .' </div>' 

} 

function a j outPhrase ( &$tab , $phrase){ 
$tab[] = $phrase; 

} 

function ecritPhrase ( &$tab ) { 

for($i = ; $i < count ($tab) ; $i++) { 
echo $tab [ $ i ] ; 

} 

} 

?> 



Dans ce fichier, nous utilisons differents types de fonctions : avec ou sans valeur de 
retour, avec des arguments disposant ou non de valeur par defaut ou avec des arguments 
passes par references. 

Ann de les ecrire dans le corps du fichier de bytecode, nous utilisons la fonction 
bcompi 1 er_wri te_functi on() pour chacune de nos fonctions. 

Regardons maintenant le simplissime code du fichier bcompiler_fonction.php : 



bcompiler_fonction.php 

<?php 

include ' bytecode/bcompiler f onction . phb' ; 
$tableau = array () ; 

$str = phraseEnCouleur ("Salut a vous !<br/>La forme ?", "#455FDB"); 

aj outPhrase ($tableau, $str) ; 

aj outPhrase ($tableau, phraseEnCouleur ( ) ) ; 

ecritPhrase ($tableau) ; 

?> 



L'utilisation est plutot simple, n'est-ce pas ? 

Cela dit, imaginez que vous ayez une cinquantaine de fonctions a compiler : il serait 
vraiment fastidieux d'ecrire cinquante fois la fonction bcompi 1 er_wri te_functi on (). Si 
toutes vos fonctions se trouvent au sein d'un meme fichier, vous pouvez utiliser la 
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fonction bcompi 1 er_wri te_functions_from_f i 1 e(). En une seule ligne, toutes les 
fonctions d'un meme fichier seront compilees et ajoutees au bytecode. 

Ouvrons a nouveau le fichier bcompiler_fonction_source.php, et remplacons les trois 
appels a la fonction bcompi 1 er_wri te_functi on ()par cette seule ligne : 

Bcompiler write functions from f ile ( $f ichierBytecode , 
'bcompiler fonction source . php' ) ; 

Le tour est joue. II ne reste plus qu'a compiler notre fichier de bytecode (en lancant le 
fichier bcompiler_fonction_source.php), et a executer de nouveau le fichier 
bcompiler _fonction.php pour s' assurer que tout fonctionne bien. 

Les classes 

Bcompiler met aussi a notre disposition un outil pour compiler des classes. Ann d'illustrer 
notre propos, nous allons creer deux fichiers : bcompiler _class_source. php et 
bcompiler _class.php. Le premier contiendra le code de quelques classes ainsi que les 
quelques lignes necessaires a leur compilation. Le second servira bien sur a tester le 
fichier de bytecode. 

bcompiler_class_source.php 

<?php 

// adresse du futur fichier compile : 
$bytecode = "bytecode/bcompiler_class . phb" ; 

// Creation du fichier compile 

$f ichierBytecode = f open ( $bytecode, "w" ) ; 

// ecriture de l'en-tete du fichier : 
bcompiler write header ( $f ichierBytecode) ; 

// ecriture des classes au sein du fichier compile 
bcompiler_write class ($ f ichierBytecode , "Animal"); 
bcompiler write class ($f ichierBytecode, "Mammif ere" ) ; 

// ecriture du pied de page du fichier : 
bcompiler write footer ( $f ichierBytecode) ; 
fclose ($f ichierBytecode) ; 

// les classes a compiler : 
class Animal { 

public $nom; 
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function construct ( $nom) { 
$this->nom = $nom; 

} 




function presentation () { 

return ' Je suis : <b>' .$this->nom. 

} 


'</b>' ; 


function seFaitManger ( $animal ) { 

return $this->nom. " : V'Rosebud !V 

} 


<br/>"; 


} 

class Mammifere extends Animal { 




public $regime; 




function construct ( $nom, $regime) { 
parent:: construct ( $nom) ; 
$this->regime = $regime; 

} 




function presentation () { 

return parent :: presentation ( ) . 
' . Mon regime : <b>' . 
$this->regime . '</b>' ; 

} 




function mange ( $animal ) { 
return $this->nom. 

' est en train de manger ' . 
$animal->nom. "<br/>" . 
$animal->seFaitManger ($this) 

} 

} 

?> 







Dans cet exemple, nous utilisons deux classes : Animal et Mammi fere. La classe Mammi fere 
heritant de la classe Animal , il est necessaire de compiler d'abord Animal , puis Mammi fere. 
Essayons de compiler de cette maniere : 

bcompiler write class ( $f ichierBytecode, "Mammifere"); 
bcompiler_write class ( $f ichierBytecode , "Animal"); 

Ce code genere une erreur car la classe Mammifere ne trouve pas sa classe mere dans le 
bytecode ! 
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Une fois que nous avons execute ce fichier (avec les classes dans le bon ordre), le fichier 
bcompiler _class.phb a ete cree. Testons-le done : 

bcompiler_class.php 

<?php 

include ' bytecode/bcompiler_class .phb' ; 

$bestiole = new Animal ( "lapin" ) ; 

echo $bestiole->presentation ( ) . "<br/>"; 

$bestiole2 = new Mammif ere ( " tigre" , "carnivore"); 

echo $bestiole2->presentation ( ) . "<br/>"; 

echo $bestiole2->mange ($bestiole) ; 

?> 

Comme pour la compilation de fonctions, 1' usage est relativement simple. Cependant, 
Bcompiler n'offre pas de fonction permettant en une seule ligne de code la compilation 
de toutes les classes d'un fichier : en effet, rien ne lui indiquerait quelle classe descend 
de quelle autre, et Bcompiler ne peut pas le deduire tout seul. 

1 0.2 Lire le bytecode 

Jusqu'a present, nous avons toujours utilise include pour lire le contenu d'un fichier de 
bytecode. Les commandes include et require resteront les manieres les plus simples et 
les plus portables d'utiliser un fichier compile. Mais il existe d'autres methodes. 

Par exemple, renommons le fichier bcompiler Jichier _proprietaire.phb (qui devrait se 
trouver dans votre repertoire bytecode) en bcompiler -^fichier _proprietaire.php : nous 
changeons seulement l'extension. Ouvrez ensuite ce fichier depuis votre navigateur 
prefere. Comme il s'agit la d'un simple script pouvant fonctionner seul, le navigateur 
affiche bien la phrase "mon fichier PHP". 

Un fichier compile, pour peu qu'il porte l'extension .php, peut done etre lu directement. 
La fonction bcompiler_read() 

Nous pouvons acceder au contenu d'un fichier compile grace a la fonction 
bcompi ler_read(). Cette fonction, contrairement aux structures include ou require, 
n' execute pas le code contenu dans le fichier. 

Creons done un fichier bcompiler _lire. php. Ce fichier devra ouvrir trois fichiers de 
bytecode (l'un contenant un script, l'autre des fonctions et le dernier des classes. Si vous 
avez fait chaque exemple de ce chapitre, vous disposez deja de ces fichiers : 
bcompiler ^fichier jproprietaire.phb pour le fichier de script, bcompiler _fonction.phb pour 
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le fichier de fonctions et bcompiler_class.phb pour le fichier de classes), puis tenter d'en 
executer le contenu. Voici le code de bcompilerjtire.php : 

bcompilerjire.php 

<?php 

/ / ouverture du fichier de bytecode contenant un script 

$f ichierBytecode = f open ( "bytecode/bcompiler fichier proprietaire . phb" , "r " ) ; 
bcompiler read ($fichierBytecode) ; 
fclose ( $f ichierBytecode ) ; 

// essai de lecture d' une variable contenue dans le script 
echo $ secret; 



// ouverture du fichier de bytecode contenant des fonctions 
$f ichierBytecode = f open ( "bytecode/bcompiler f onction . phb" , "r " ) ; 
bcompiler read ($fichierBytecode) ; 
fclose ( $f ichierBytecode ) ; 

// essai d' utilisation de ces fonctions 
$tableau = array () ; 

$str = phraseEnCouleur ("Salut a vous !<br/>La forme ?", "#455FDB"); 

a j outPhrase ( $tableau , $str) ; 

aj outPhrase ($tableau, phraseEnCouleur ( ) ) ; 

ecritPhrase ($tableau) ; 

// ouverture du fichier de bytecode contenant des classes 
$f ichierBytecode = f open ( "bytecode/bcompiler_class . phb" , " r " ) ; 
bcompiler read ($f ichierBytecode) ; 
fclose ( $f ichierBytecode) ; 

// essai d' utilisation de ces classes 

$bestiole = new Animal (" lapin" ) ; 

echo $bestiole->presentation ( ) . "<br/>"; 

$bestiole2 = new Mammif ere ( "tigre" , "carnivore"); 

echo $bestiole2->presentation ( ) . "<br/>"; 

echo $bestiole2->mange ($bestiole) ; 

?> 

Lorsque nous lancons ce fichier, nous nous rendons compte que le fichier de script ne 
s'execute pas (la phrase "mon fichier PHP" n'apparait pas a l'ecran). De plus, la variable 
$secret ne s'affiche pas non plus. Et pourtant, aucune erreur ne nous est renvoyee. 
Par contre, les fichiers de fonctions et de classes s'executent correctement. 

Quels avantages y a-t-il a utiliser cette fonction ? Si nous comparons les temps d'execution, 
nous ne pouvons noter de differences significatives. Le seul avantage est de pouvoir charger 
ces fichiers compiles en un seul et meme endroit du code, pour plus de clarte. 
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La fonction bcompiler_load() 

Comme nous l'avons vu precedemment, un fichier compile pese environ cinq fois plus 
lourd que son alter ego non compile. Heureusement, l'extension Bcompiler nous propose 
une petite fonction afin de resoudre ce probleme de poids. En effet, 
bcompi ler_load() permet de charger un fichier de bytecode compresse avec BZIP2 ! 

Vous pouvez vous reporter au chapitre Comprimez vos donnees, traitant de la 
compression, pour plus de details sur la maniere d'utiliser BZIP2. 

Nous allons, en un seul petit fichier (place dans votre repertoire chaplO), nomme 
bcompiler _bzip-php, compresser le fichier bcompiler _class.phb (si vous avez effectue les 
exemples de ce chapitre, il devrait deja exister dans le dossier bytecode) puis utiliser les 
classes contenues dans notre fichier compile-compresse. 

Voici le code de bcompiler_bzip-php : 

^ bcompiler_bzip.php 

<?php 

$f ichierSource = ' bytecode/bcompiler class. phb'; 

// recuperation, sous la forme d' une chaine 

// de caracteres, du contenu du fichier de bytecode : 

$contenu = f ile_get_contents ($f ichierSource) ; 

// on ecrit le contenu du fichier de bytecode 
// a l'ecran : 
echo "<p>"; 
echo $contenu; 
echo "</p>"; 

// On s'apergoit bien, grace a tous les caracteres 

// bizarres inscrits a l'ecran, qu' il s'agit ef f ectivement 

// du contenu du fichier de bytecode ! 

// ouverture (ou creation) du fichier compresse : 
$bzo = bzopen ( ' bytecode/compile compresse . bz2 ' , "w"); 

// Ecriture du code compile dans le fichier compresse : 
bzwrite ($bzo, $contenu, strlen ( $contenu ) ) ; 

// Fermeture du fichier compresse : 
bzclose ( $bzo ) ; 

// chargement des classes contenues 

// dans notre fichier compile-compresse : 
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bcompiler load ( ' bytecode/compile compresse .bz2' ) ; 

// Execution de ces classes : 

$bestiole = new Animal ( "lapin" ) ; 

echo $bestiole->presentation ( ) . "<br/>"; 

$bestiole2 = new Mammif ere ( "tigre" , "carnivore"); 

echo $bestiole2->presentation ( ) . "<br/>"; 

echo $bestiole2->mange ($bestiole) ; 

?> 

Et voila ! Nos classes ont ete d'abord compilees en un fichier de bytecode, puis 
compressees grace a BZIP2. A cet effet, le fichier compile_compresse.bz2 pese environ 
quatre fois moins lourd que bcompiler _class.phb, son homologue non compresse. 

Malheureusement, bcompi ler_load()ne s'utilise qu'avec des classes. Si vous esperiez 
compresser du script ou des fonctions compilees, il va falloir passer votre chemin. 

Enfin, si nous gagnons en place, nous perdons en vitesse d' execution. C'est evidemment 
normal, puisque nous subissons une etape de decompression. Un fichier compile et 
compresse met environ deux fois plus de temps qu'un autre a s'executer. 

Maintenant, c'est a vous de determiner quelle methode de compilation va etre la plus 
adaptee a votre projet : faut-il compiler du script ? Des fonctions ? Des classes ? Tout a 
la fois ? Faut-il compresser ? 

Et surtout, n'oubliez pas de vous poser la plus importante de toutes les questions : queries 
parties de mon programme sont suffisamment sensibles pour justifier leur compilation et 
la perte de performances (en termes de poids ou de rapidite d'execution) qui va avec ? 

10.3 Check-list 

Dans ce chapitre, nous avons decouvert ce qu'etait Bcompiler, ses avantages et ses 
inconvenients. 

Nous avons vu comment : 

>/ compiler vos fichiers PHP ; 

</ compiler des classes et des fonctions ; 

lire des fichiers, des classes ou des fonctions compiles ; 

lire des fichiers compiles et compresses. 
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Ce chapitre a pour objectif de vous donner des pistes 
afin d'etudier des extensions que vous ne connaissez 
pas encore, et ce par vous-meme. II est facile de travailler 
une extension lorsque celle-ci est documentee. Mais 
comment faire lorsqu'elle ne Test pas ? 
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11.1 Avant de commencer... 

Chacun est unique. Les auteurs sont aussi uniques que vous l'etes vous-meme. Ces deux 
premieres phrases sont la pour prevenir que, meme si les differentes ecoles essayent plus 
ou moins et tant bien que mal d'enseigner une pensee assez similaire et formatee, vous 
n'en restez pas moins des etres humains. D'ailleurs, pourquoi avez-vous choisi 
l'informatique et pas la psychologie, l'histoire ou l'ethnologie ? Tout simplement parce 
que vous avez un passe, un vecu, avec des souvenirs, des reflexes conditionnes et 
inconscients. Et c'est sans compter le sujet de la memoire cellulaire et des heritages 
transgenerationnels. Voila pourquoi vous avez choisi l'informatique au point d'en faire 
une profession ou si ce n'est pas encore le cas, de vouloir en faire une profession ou 
encore un simple loisir. Done, recuperez parmi les explications qui seront donnees dans 
ce chapitre tout ce qui vous semble etre le meilleur pour vous et laissez de cote ce qui 
vous semble inutile, inefficace, voire meme ridicule. Chacun possede son mode de 
pensee, sa logique et son ressenti. Et il y a autant de bonnes facons de faire pour atteindre 
un meme resultat escompte qu'il y a d'etres vivants. 

ConnaTtre ses motivations 

Connaitre ses besoins est la premiere chose a faire. En effet, comment peut-on evoluer si 
on ne sait pas ou Ton va ? Rappelez-vous votre passe d'ecolier, de collegien, de lyceen, 
rappelez-vous ces longs cours de mathematiques ou Ton vous apprenait a calculer une 
integrate, sans meme savoir a quoi cela pouvait servir, ou si vous alliez utiliser cette 
connaissance a l'avenir. Mais peut-etre ce jeu sans but vous amusait... 

Quoi qu'il en soit, sans motivations, vous n'irez jamais bien loin dans vos decouvertes. 
Alors, pourquoi apprenez-vous a utiliser telle ou telle extension ? Est-ce pour repondre a 
un besoin precis d'un projet ? Est-ce pour elargir le champ de vos connaissances et de vos 
competences ? Pour epater quelqu'un ? Pour vous epater vous-meme ? Est-ce tout 
simplement par jeu ? II n'y a pas de mauvaises reponses. L'important, ce n'est meme pas 
forcement de savoir pourquoi mais de savoir comment. Comment allez-vous trouver la 
bonne extension ? Comment allez-vous trouver les bonnes documentations et ne pas vous 
perdre dans un not de donnees inutile et consommateur de temps ? Comment allez-vous 
integrer et memoriser les informations necessaires a l'utilisation de facon naturelle, sans 
aide constante, la nouvelle extension ou API ou autre ? Comment ? 

Savoir ce que vous ne savez pas 

C'est une reflexion qui a toute son importance. Car s'il est tres facile de savoir ce que Ton 
sait, surtout consciemment, il est beaucoup plus difficile de savoir ce que Ton ne sait pas. 
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Et quand vous vous rendez compte d'une non-connaissance, cela s'ensuit d'un acte 
encore plus difficile, celui d'admettre et de se confronter a la realite du fait. Et plus le 
niveau du programmeur est eleve, plus il a du mal a se remettre en question. Beaucoup 
croient se remettre en question. Mais ne seraient-ils pas en train de se donner une bonne 
raison de ne pas le faire ? Se remettre en question ne signifie pas forcement avoir 
conscience de ce que Ton ne sait pas. Ne pas savoir. . . A partir du moment ou vous prenez 
conscience et que vous admettez en votre for interieur que vous ne savez pas, alors vous 
etes sur le bon chemin pour apprendre. 

Quand est-ce que c'est le plus difficile d'admettre, de nous avouer que Ton ne sait pas ? 
Quand on a pris une habitude qui fonctionnait jusque-la mais qui aujourd'hui montre ses 
limites. . . Et plus l'habitude dure depuis longtemps, moins on a envie d'admettre que c'est 
une mauvaise habitude. On a cru qu'elle etait bonne pendant des annees. Pourquoi 
aujourd'hui serait-elle mauvaise ? Parce que la vie est mouvement et que tout change a 
chaque milliardieme de seconde. Pour ceux parmi vous qui modelisez des bases de 
donnees, tous savent que la premiere solution, aussi bonne soit-elle, n'est jamais la 
meilleure. Tout comme pour la modelisation objet. 

Apprendre une extension pour les besoins d'un projet 

Si vous devez apprendre une extension pour le bien d'un projet, la premiere question a 
se poser est celle de l'absolue necessite de 1' extension en question. 

Par exemple, vous devez realiser un export de certaines donnees contenues dans une base 
au format Microsoft Excel. La reponse est deja claire : il va vous falloir apprendre COM. 
En etes-vous bien stir? N'y aurait-il pas d'autres solutions plus simples, ne vous 
imposant pas un temps d'apprentissage ? 

La reponse est oui : creez un fichier CSV (Comma-Separated Value, pour plus de 
renseignements, rendez-vous a l'adresse suivante : http://tools.ietf.org/html/rfc4180). Vous vous 
contenterez de faire de la simple concatenation de chaines de caracteres, et votre export 
sera compris par 1' immense majorite des tableurs du marche. Ce qui represente un gain 
de temps phenomenal. Sachez qu'en plus, il existe une fonction interne au moteur PHP 
nominee fgetcsv() pour exploiter au mieux et tres facilement tout fichier CSV. 

La reponse est non : vous avez besoin d'utiliser certaines fonctions propres a 
Microsoft Excel. Et en plus de cela, votre client vous a clairement signifie qu'il desirait 
un fichier au format Excel et rien d' autre. 
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Apprendre une extension pour soi-meme 

Vous avez ete exile dans une ville lointaine, ou vous ne connaissez personne. Qu'a cela 
ne tienne, vous allez approfondir vos connaissances en PHP car vous avez le materiel 
requis a disposition. Vous n'avez pas de cahiers des charges, encore moins d'objectifs ; 
il n'y a que vous face a votre liberte. Eh bien, il est vivement conseille de chasser ces 
pensees de votre esprit. C'est une erreur qu'il vous faut corriger. Et si PHP est ce qu'il 
est aujourd'hui, c'est grace a la communaute qui s'est tres rapidement formee autour de 
ce langage. La communaute de PHP est l'une des plus puissantes du monde informatique 
avec quelques autres comme Linux. 

Vous allez travailler une demi-heure en suivant un tutoriel quelconque, le temps de voir 
comment fonctionne votre extension. Et puis apres ? II vous faut un projet, quelque chose, 
meme completement inutile, au sein duquel vous allez exploiter votre extension, faire des 
experiences, tout planter, tout reussir, etc. Allez-y, faites fonctionner vos meninges, 
explorez les meandres de votre imagination. Non seulement vous allez apprendre ce que 
vous souhaitiez, mais vous allez aussi reviser vos acquis, ancrer un peu plus en vous les 
reflexes de programmation, trouver de meilleurs algorithmes que ceux que vous utilisiez 
deja. Et qui sait. .. peut-etre allez-vous avoir l'idee du siecle, celle qui changera votre vie 
(en mieux, du moins c'est ce que nous vous souhaitons) ! 

1 1 .2 Differentes methodes 
Extension documentee 

Le terme "extension documentee" veut dire que l'extension est documentee dans le 
manuel officiel de PHP. Vous pouvez avoir acces a ce manuel sur le site http://php.net/. 

En ce qui concerne les extensions documentees, la methodologie reste a peu pres la 
meme. Apprendre par coeur les syntaxes de chaque fonction. Certains se disent deja : a 
quoi 9a sert ? 

Pensez-vous que vous pourriez parler francais aujourd'hui sans avoir eu a apprendre par 
coeur un certain nombre de mots de telle sorte que vous savez les employer au moment 
opportun ? II est fort probable que non et il en est de meme des regies syntaxiques et 
grammaticales. Pensez-vous que vous pourriez courir, ou sauter des obstacles si vous 
n'aviez pas appris a marcher avant ? Tout ce qui est devenu naturel pour vous a forcement 
ete appris par cceur afin de devenir inne. 

C'est exactement pared pour la programmation et done pour la programmation PHP. 
Apprenez par coeur, encore et encore. Puis pratiquez, testez durant des jours, des 
semaines. Trouvez un projet utile a programmer avec cette nouvelle extension que vous 
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etes en train d'etudier. Un projet que vous pourrez reutiliser afin de l'integrer dans un 
autre projet. Par exemple, si vous etudiez les sockets, programmez un chat. Si vous 
etudiez l'extension Crack, programmez un verificateur de mots de passe. Cherchez 
toujours un projet qui vous permet de rentabiliser le temps passe a etudier la nouvelle 
extension. 

Extension non documentee 

En ce qui concerne les extensions non documentees, il n'y a pas de methode definie. Tout 
depend de l'extension. Est-elle programmee en C puis compilee afin d'etre integree dans 
les extensions PHP ? Est-elle programmee en PHP comme le sont les paquets PEAR ? 
Est-elle programmee en POO (Programmation orientee objet) ou non ? Tout cela a son 
importance. Le premier reflexe est d'utiliser 1' introspection (ou reflexion) que vous avez 
etudiee dans le chapitre 8 avec les classes Reflection*. Puis, la plupart du temps, l'etape 
suivante est de se plonger dans les sources de l'extension, d'oii l'interet de connaitre 
egalement la programmation C. 

Si 1' introspection donne une bonne description des fonctions, alors la methode devient la 
meme que pour les extensions documentees : apprendre par coeur les fonctions et leur 
structure. Sinon, a l'etude des sources, toutes les fonctions de types publics sont 
repertoriees et sont a memoriser, par coeur. 

Dans les deux cas (reflexion ou non), les auteurs d'une extension lui cherchent une 
logique et se posent les questions suivantes : 

Comment structurer l'extension ? 
Quel peut etre son objectif ? 
Que peut-on en faire ? 

Pour quel projet, quelle application, cette extension peut s'averer utile ? 

A vous de trouver les bonnes reponses. Si vous comprenez la logique d'une extension, 
vous avez deja effectue la moitie du travail. 

Et si je ne veux pas apprendre par coeur ? 

Vous estimez que vous avez passe l'age de declamer des poesies devant le tableau noir ? 
Vous vous refusez a verifier n'importe oil n'importe quand que vous vous rappelez bien 
du fonctionnement de telle extension, de telle fonction ? Que le travail, c'est le travail, et 
que 1' apprentissage d'une nouvelle extension n'a pas a gacher votre journee ? 

Vous avez choisi la voie la plus longue. Car, pour etre certain de vos connaissances, il va 
vous falloir enchainer quelques centaines de petits projets personnels, et mettre a profit le 
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maximum de temps libre pour cela. Oui : du temps libre, car ce ne sont pas ces petits 
projets personnels qui, bien que pedagogiques, vous nourriront. Vous allez passer trois 
jours chez votre belle-famille que vous ne supportez pas ? Parfait, vous savez ce qu'il 
vous reste a faire... 

1 1 .3 Quelques conseils d'ordre general 
Apprendre de ses erreurs 

Lorsque vous travaillez sur une extension, sur un de ces petits projets qui n'ont que 
1' apprentissage pour vocation, vous allez, en plus d' apprendre de nouvelles choses, 
reviser. Vous n' allez pas utiliser que les fonctions de votre extension. Vous allez chercher 
des donnees dans une base ou dans un fichier XML, concatener des chames, elaborer des 
algorithmes, etc. 

Toutes les manipulations que vous allez effectuer peuvent etre source d'erreurs : une 
fonction mal utilisee avec le mauvais nombre d' arguments, un algorithme sans fin, des 
erreurs de casse et ainsi de suite. 

Essayez de reperer quel est le genre d'erreurs que vous faites le plus souvent, et 
demandez-vous pourquoi. Est-ce parce que vous avez de mauvaises habitudes de 
programmation ? Ou parce que vous confondez deux mots semantiquement proches ? Ou 
bien, saturez-vous la memoire de votre serveur, jusqu'a sa capitulation ? De nombreuses 
raisons sont possibles, et il existe une solution pour chacune d'entres elles. A vous de la 
trouver arm de corriger vos erreurs tout en vous rendant plus performant, plus stir de 
vous-meme. 

Voici un bon exercice de fond, a pratiquer regulierement : reprenez vos anciens travaux 
et ameliorez leurs algorithmes, epurez votre code, raccourcissez-le le plus possible ! Vous 
ne corrigerez pas d'erreurs, mais vous vous ameliorerez dans votre maniere de concevoir 
vos algorithmes. Vous les ferez ainsi plus courts dans vos projets suivants, et done a la 
fois plus performants et plus rapides ; et, comme il y a moins de code, vous limiterez 
aussi le nombre d'erreurs possibles. 

Utiliser toute I'aide disponible 

Lorsque vous decouvrez une nouvelle extension, il est illusoire de penser que vous vous 
en sortirez seulement avec la documentation fournie (encore faut-il qu'elle existe). Plus 
vous multiplierez vos sources de documentations, plus vous decouvrirez des manieres de 
proceder differentes. Vous decouvrirez des algorithmes puissants auxquels vous n'aviez 
pas pense, des f aeons originales d' utiliser certaines fonctions... 
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N'ayez pas peur d'ecumer les forums de developpeurs pour trouver la reponse a une 
question precise, ou a poser vous-meme votre question. II y aura toujours quelqu'un pour 
vous repondre, vous aider dans la resolution de votre probleme, ou vous proposer une 
solution de secours. 

Quand vous demarrez l'apprentissage d'une extension (ou de n'importe quoi d' autre, 
d'ailleurs), recherchez des tutoriels sur Internet et suivez-les. Vous verrez ainsi differentes 
manieres d'utilisation, ouvrant de nouveaux horizons. 

Avant meme de commencer a apprendre, consultez les blogs de developpeurs : il y en a 
forcement qui ont deja pris la route que vous vous appretez a suivre. Vous trouverez des 
retours d' experiences, ce qui vous permettra de savoir si, oui ou non, telle extension 
merite d'etre apprise ou non... De plus, sur ces blogs, vous trouverez des informations 
que vous n'aviez pas prevues de chercher et qui vous ouvriront peut-etre de nouvelles 
voies. 

Tous les livres peuvent vous apprendre quelque chose en la matiere : vous y trouverez les 
avis et les conseils de quelqu'un qui a vraiment explore un sujet a fond. Ne dedaignez pas 
non plus les magazines specialises. 

Et enfin, certainement la methode la plus efficace et la plus agreable pour obtenir de 
l'aide, c'est de la demander a vos amis developpeurs (si vous en avez). Avez-vous deja 
passe un apres-midi en compagnie d'un ami, a tripoter des lignes de codes, tous les deux 
face a la meme machine ? Chacun apprend de 1' autre et, surtout, vous partagez un 
agreable moment ensemble. Et tout le monde sait que Ton apprend mieux et plus vite, et 
que Ton est globalement plus performant quand on se sent bien. 

1 1 .4 Check-list 

Ce chapitre, indispensable, vous a permis d'aborder les points suivants : 
*/ se connaitre ; 

s/ savoir ce que Ton ne sait pas ; 

*f ce qu'il faut apprendre et pourquoi ; 

</ comment apprendre ; 

l'interet de collaborer (programmer a deux ou plus) ; 
*/ l'interet de profiler de tous les medias mis a disposition. 
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2 Annexes 



12.1 Webographie 



PHP 

http://php.net/ : le site officiel de PHP toutes versions confondues ; 

http://nexen.net/ : toute l'actualite de PHP ; 

http://afup.org/ : Association francaise des utilisateurs de PHP ; 

http://developpez.com/ : le site des developpeurs francophones ; 

www.developpez.net/forums/ : les forums du site developpez.com/ ; 

http://www.developpez.net/forums/showthread.php?t=6088 : optimisation PHP/MySQL ; 

http://snaps.php.net/ : les versions non stables de PHP dont PHP6 ; 

www.corephp.co.uk/ : l'equipe qui travaille sur PHP ; 

www.phpmvc.net/ : tout sur le MVC {Model View Controller) en PHP 

SQL 
Normes 

http://savage.net.au/SQL/sql-92.bnf.html : la norme SQL92 version HTML ; 
http://savage.net.au/SQL/sql-99.bnf.html : la norme SQL99 version HTML ; 
http://savage.net.au/SQL/sql-2003-l.bnf.html : la norme SQL2003 version HTML (part 1) 
http://savage.net.au/SQL/sql-2003-2.bnf.html : la norme SQL2003 version HTML (part 2) 
http://savage.net.au/SQL/sql-2003-core-features.html : pour les perfectionnistes ; 
http://savage.net.au/SQL/sql-2003-noncore-features.html : et les insomniaques. 

MySQL 

www.mysql.com/ : le site officiel du SGBD en anglais ; 

www-fr.mysql.com/ : le meme que le precedent et en francais ; 

http://dev.mysql.com/ : la zone des developpeurs avec MySQL6 en telechargement. 

PostgreSQL 

http://www.postgresql.org/ : le site officiel de PostgreSQL ; 
http://www.postgresqlfr.org/ : le site francais pour PostgreSQL ; 
http://docs.postgresqlfr.org/ : la documentation francaise de PostgreSQL. 

Linux 

www.debian.org/ : le site francais le plus complet sur Debian ; 
www.debian-fr.org/ : le site sur Debian et aussi GNU/Linux 
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www.gentoo.org/ : le site officiel de Gentoo ; 
www.gentoo.org/doc/fr/ : la documentation Gentoo ; 
www.gentoofr.org/ : le site Gentoo francophone ; 

http://fluxbox.sourceforge.net/ : le bureau graphique pour Linux, tres leger et tres rapide. 

Autres 

www.cru.fr/ : le Comite reseau des universites contient de tres nombreuses informations 
et de liens, notamment en ce qui concerne LDAP (www.cru.fr/ldap/) ; 
www.openldap.org/ : le site officiel OpenLDAP ; 

http://www.openlaszlo.org/ : Flash version OpenSource, pour les codeurs acharnes ; 
http://tools.ietf.org/html/rfc4517 : LDAP Schema for User Applications ou vous trouverez, 
entre autres, la signification des abreviations (c pour country, etc.) et comment les 
utiliser ; 

http://userpage.chemie.fu-berlin.de/diverse/doc/ISO_3166.html : la liste des abreviations des 

pays en deux lettres, trois lettres et leur code numerique ; 

www.fpdf.org/ : le site ou telecharger FPDF et se documenter sur le sujet ; 

http://www.imagemagick.org/script/index.php : le site ou telecharger ImageMagick ; 

www.magickwand.org/ : le site ou telecharger MagickWand ; 

http://milwOrm.com/ : la description de failles, et une mise a jour hebdomadaire ; 

http://www.devshed.com/ : un site web tres bien fourni pour le webmastering 

http://www.pantz.org/ : diverses informations sur beaucoup de domaines en informatique. 

12.2 Fonctions des extensions 

Voici la liste de toutes les fonctions etudiees dans cet ouvrage. 



APC 




Tableau 12.1 : APC 



Les fonctions Les arguments 



Leur description 

Met une variable en cache, sauf si elle a deja 
ete stockee. 



bool apc_add 



chaine $key, mixe $valeur [, 
entier $duree_de_vie ] 
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^ Tableau 12.1 : APC 
bool apc_cl ear_cache 



chaine $cache_type 



bool apc_defi ne_constants 



chaine $key, tableau 
$constantes [, bool 
$case sensitive ] 



bool apc_delete 



chaine $key 



mixe apc_fetch 



chaine $key 



bool apc_l oad_content 



chaine $key [, bool 
$case_sensitive ] 



bool apc_store 



chaine $key, mixe $valeur [, 
entier $duree de vie ] 



Efface le cache APC. Si $cache_type vaut 
"user", le cache utilisateur sera nettoye ; sinon, le 
cache systeme (les fichiers mis en cache] sera 
nettoye. 



Definit un jeu de constantes. Le parametre $key 
est utilise comme identifiant du jeu de constantes 
et sert d les recuperer en utilisant la fonction 
ape load constants(). 



Efface une variable du cache. Le parametre $key 
correspond d celui utilise pour stacker la variable. 



Recupere une variable depuis le cache. Le 
parametre $key correspond d celui utilise pour 
stacker la variable. 



Recupere un jeu de constantes depuis le cache. 



Met une variable en cache 



Bcompiler 



Tableau 12.2 : Bcompiler 


Les fonctions 


Les arguments 


Leur description 


bool bcompiler load 


Lit les donnees depuis le fichier compresse 
bzippe $filename et cree les classes depuis le 
bytecode. 




chaine $filename 


bool bcompiler read 


Lit les donnees depuis un fichier ouvert 
represents par le descripteur $filehandle et 
cree les classes depuis ie bytecode. 




resource $filehandle 
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Tableau 12.2 : Bcompiler 



bool bcompiler write class 


Lit le bytecode d'une classe existante nommee 
$cl assName depuis PHP et 1 ecrit dans le fichier 
ouvert designe par le descripteur $filehandle. 




resource $filehandle, chaTne 
$className [, chaTne $extends 
] 


bool bcompiler write file 


Compile le fichier $filehandle et ecrit le 
resultat dans le fichier $filename. 




resource $filehandle, 
chaTne $filename 


bool bcompiler write footer 


Indique la fin des donnees d compiler. 




resource $filehandle 


bool bcompiler write function 


Ecrit la fonction $functionname dans le fichier 
$filehandle. 




resource $filehandle, chaTne 
$functionname 


bool bcompiler write functions from file 


Recherche toutes les fonctions presentes dans le 
fichier $filename et ecrit leur bytecode dans le 
fichier $fi 1 ehandl e. 






bool bcompiler write header 


Ecrit I'en-tete Bcompiler. 




resource $filehandle [, 
chaTne $write ver ] 


BZIP2 


Tableau 12.3 : BZIP2 


Les fonctions 


Les arguments 


Leur description 


entier bzclose 


Ferme un fichier ouvert avec la fonction 
bzopenQ. 




resource $bzo 


mixte bzcompress 


Compresse une chaTne de donnees en fonction 
d un taux de compression et d un facteur de 
travail. 




chaine $donnees 

[, entier $taux compression 

[, entier 

$facteur de travail]] 
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Tableau 12.3 : BZIP2 



mixte bzdecompress 


Decompresse une chaTne de donnees 
compressee avec la methode bzcompress () . 




chaine $donnees compressees 
[, entier $smalT] 


tableau bzerror 


Retourne un numero et un message d'erreur 
stockes dans un tableau. 




ressource $bz 


entier bzerrno 


Retourne un numero d'erreur BZIP2. 




ressource $bz 


chaine bzerrstr 


Retourne un message d'erreur BZIP2. 




ressource $bz 


ressource bzopen 


Ouvre un fichier compresse au format BZIP2. 




chaine $nom fichier, 
chaine $mode ouverture 


chaine bzread 


Lit le contenu d'un fichier BZIP2 en fonction 
d un nombre de caracteres determine. 




ressource $bzo 

[, entier $nb caract max] 


entier bzwrite 


Ecrit des donnees dans un fichier BZIP2 ouvert 
via la fonction bzopen (). 




ressource $bzo, 
chaine $donnees 
[, entier $nb caract max] 


Classkit 


Tableau 12.4 : Classkit 


Les fonctions 


Leurs arguments 


Leur description 


bool classkit method add 


Ajoute dynamiquement une methode dans une 
classe. 




chaine $nom classe, 
chaine $nom methode, 
chaine $args, 
chaine $code 
[, entier $drapeaux] 



300 



Fonctions des extensions 12 




Tableau 12.4 : Classkit 



bool classkit method redefine 


Redefinit dynamiquement une methode dans 
une classe. 




chaTne $nom classe, 
chaine $nom methode, 
chaTne $args, 
chaTne $code 
[, entier $drapeaux] 




classkit method remove 


Supprime dynamiquement une methode dans 
une classe. 




chaTne $nom_classe, 
chaTne $nom methode 


bool classkit method rename 


Renomme dynamiquement une methode dans 
une classe. 




chaine $nom classe, 
chaine $nom methode, 
chaine $nouveau nom methode 



DOM 



Fonctions de l'objet DOMDocument 



Tableau 12.5 : DOM 


Les fonctions Les arguments 


Leur description 


DOMElement createEl ement 


Cree une nouvelle instance de DOMElement. Pour 
integrer ce nceud dans un document, utiliser la 
fonction DOMNode: :appendChild(). 


chaTne $name [, chaTne 
$val ue] 

1 


DOMElement createEl ementNS 


Cree un nouveau nceud avec un espace de 
nom. Pour integrer ce noeud dans un document, 
utiliser la fonction DOMNode: :appendChild(). 


chaTne $namespaceURI , chaTne 
$qualifiedName [, chaTne 
$value] 


DOMText createTextNode 


Cree un nouveau nceud texte. Pour integrer ce 
nceud dans un document, utiliser la fonction 
DOMNode: : appendChi 1 d () . 


chaTne $content 


DOMNodeLi st getEl ementsByTagName 


Retourne une instance de DOMNodeLi st 

contenant tous les elements du document dont le 
nom de balise vaut $name. 


chaTne $name 
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Tableau 12.5 : DOM 



DOMNodeLi st getEl ementsByTagNameNS 


Retourne une instance de DOMNodeLi st 
contenant tous les elements du document dont 
I'espace de nom vaut $namespaceURI et le nom 
vaut $local Name. 




chaine $namespaceURI , chaine 
$localName 


mixe load 


Charge un fichier XML. Retourne TRUE ou FALSE 
en cas de succes ou d echec. Si appelee 
statiquement, retourne un objet DOMDocument. 




chaine $filename [, entier 
$opti on] 


mixe save 


Enregistre un fichier XML depuis une 
representation DOM. Retourne le nombre 
d'octets ecrits ou FALSE en cas d'erreur. 




chaine $filename 
[, entier $option] 



Fonctions de l'objet DOMElement 



Tableau 12.6 : Fonctions de l'objet DOMElement 


Les fonctions 


Les arguments 


Leur description 


chaine getAttribute 


Retourne la valeur de I'attribut dont le nom est 
$name. 




chaine $name 


bool setAttribute 


Cree un attribut ayant $name pour nom et 
$val u.e pour valeur. 




chaine $name, chaine $value 


void setAttri buteNS 


Cree un attribut avec $namespaceURI comme 
espace de nom, $qual ifiedname comme nom, 
et $value comme valeur. 




chaine $namespaceURI , chaine 
$qual i f i edname, chaine $value 



Fonctions de l'objet DOMNode 



Tableau 12.7 : Fonctions de l'objet DOMNode 


Les fonctions Les arguments 


Leur description 


DOMNode appendChild 


Ajoute un nceud enfant d la fin de la liste des 
noeuds enfants dejd existants. 


DOMNode $nouveauNoeud 

1 
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Tableau 12.7 : Fonctions de I'objet DOMNode 


bool hasChi 1 dNodes 


Verifie si un nceud a des enfants. 




Aucun argument. 




FPDF 


^ Tableau 12.8 : FPDF 




Les fonctions 


Les arguments 


Leur description 


AddPage 


Ajoute une nouvelle page au document. Le 
parametre $orientation permet de choisir le 




[chaine $orientation] 


sens de la page : 'P' pour Portrait ou 'L' pour 
Paysage. 


AliasNbPages 


Definit un alias pour le nombre total de pages. 




[chaine $alias] 




Cell 


Ecrit une chaine de caracteres dans une cellule 
et place cette cellule aux coordonnees 
courantes. 




flottant $largeur [, flottant 
$hauteur [, chaine $texte [, 
mixe $bordure [, entier 
$interligne [, chaine 
$alignement [, entier 
$remplissage [, mixe $1 1 en 
]]]]]]] 


Close 


Termine le document PDF. Cette fonction est 
appelee explicitement par la fonction Output. 






GetStringWidth 


Permet de connaTtre la longueur d'une chaine 
de caracteres avec la police de caracteres 
courante. 




Chaine $chaine 


Image 


Place une image dans la page. 




chaine $fichier, flottant $x, 
flottant $y [, flottant 
$largeur [, flottant $hauteur 
[, chaine $type [, mixe $1 i en 
]]]] 
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Tableau 12.8 : FPDF 



Line 


Trace une ligne entre deux points. 


flottant $xl, flottant $yl, 
flottant $x2, flottant $y2 


Ln 


Revient a la ligne (retour cha riot) . 




flottant $interligne 


Mul ti cell 


Permet de creer un bloc de texte. 




flottant $largeur, flottant 
$hauteur, chaine $texte [, 
mixe $bordure [, chaine 
$al ignement [, entier 
$rempl issage ]]] 


Output 


Envoie le document vers la sortie standard (le 
navigateur, le plus souvent) sous forme de 
chame, ou enregistre le fichier. 




[chaine $nom [, chaine 
$destination ]] 


PageNo 


Renvoie le numero de page courant. 






Rect 


Dessine un rectangle. 




flottant $x, flottant $y, 
flottant $largeur, flottant 
$hauteur [, chaine $style ] 


SetAuthor 


Definit I'auteur du document. 




chaine $auteur 


SetCreator 


Definit le nom du createur. En general, le nom 
de I'application qui a genere le nom du 
document. 




chaine $createur 


SetDrawCol or 


Definit la couleur courante des traces et 
contours. 




entier $rouge, entier $vert, 
entier $bleu 


SetFillColor 


Definit la couleur de remplissage courante. 




entier $rouge, entier $vert, 
entier $bleu 
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Tableau 12.8 : FPDF 



SetFont 




Definit la police de caracteres courante, ainsi 
que sa taille. 




chaine $famille [, chaine 
$style [, flottant $taille ]] 


SetKeywords 


Associe des mots-cles au document. 




chaine $motClef 




SetLineWidth 




Fixe I'epaisseur des traits. La valeur par defaut 
est 0.2. 




flottant $epaisseur 


SetSubject 


Definit le sujet du document. 




chaine $sujet 




SetTitle 


Definit le titre du document. 




chaine $titre 




SetX 


Change la coordonnee x de la position 
courante. 




flottant $x 


SetY 


Change la coordonnee y de la position 
courante. 




flottant $y 


SetXY 


Change les coordonnees de la position 
courante. 




flottant $x, flottant $y 


GD2 


Tableau 12.9 : GD2 


| 


Les fonctions 


Les arguments 


Leur description 


tableau getimagesize 


Determine la taille de I'image fournie et en 
retourne les dimensions, le type d'image et une 




chaine $filename [, tableau 
&$imageinfo] 


chaine type height/width d placer dans une 
balise HTML IMG normale et le type de contenu 
HTTP correspondent. 
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Tableau 12.9 : GD2 



entier imagecol oral! ocate 


Retourne un identifiant de couleur RVB. 




resource $image, entier 
$rouge, entier $vert, entier 
$bleu 


bool imagecopyresized 


Copie une partie de I'image source dans une 
image de destination. 




resource $image destination, 
resource $image source, 
entier $dst x, entier $dst y, 
entier $src x, entier $src y, 
entier $dst largeur, entier 
$dst hauteur, entier 
$src largeur, entier 
$src hauteur 


resource imagecreate 


Cree une nouvelle image d palette. 




entier $largeur, entier 
$hauteur 


resource imagecreatefromgi f 


Cree une nouvelle image GIF d partir d'un 
fichier. 


chaine $filename 


resource imagecreatefromjpeg 


Cree une nouvelle image JPEG d partir d'un 
fichier. 


chaine $filename 


resource imagecreatefrompng 


Cree une nouvelle image PNG d partir d'un 
fichier. 




chaine $filename 


resource imagecreatetruecol or 


Cree une nouvelle image trueColor. 




entier $largeur, entier 
$hauteur 


resource imagecreatefromwbmp 


Cree une nouvelle image WBMP d partir d'un 
fichier. 




chaine $filename 


bool imagedestroy 


Libere la memoire occupee par I'image $image. 




resource $image 
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Tableau 12.9 : GD2 



bool imagef i 1 1 edrectangl e 


Dessine un rectangle rempli avec la couleur 
$coul eur. 




resource $image, entier $xl, 
entier $yl, entier $x2, entier 
$y2, entier $couleur 


bool imagegif 


Envoie une image GIF vers un navigateur ou un 
fichier. 




resource $image [, chaine 
$filename ] 


bool imagejpeg 


Envoie une image JPEG vers un navigateur ou 
un fichier. 




resource $image 

[, chaine $filename ] 


bool imageline 


Dessine une ligne de couleur $couleur. 




resource $image, entier $xl, 
entier $yl, entier $x2, entier 

$y2, 

entier $couleur 


bool imagepng 


Envoie une image PNG vers un navigateur ou 
un fichier. 




resource $image 

[, chaine $filename ] 


bool imagesetthi ckness 


Specifie I'epaisseur d un trait. 




resource $image, entier 
$epaisseur 


bool imagechaTne 


Dessine une chaine de caracteres aux 
coordonnees specifiees, et de couleur 
$coul eur. 




resource $image, entier 
$font, entier $x, entier $y, 
entier $chaTne, entier 
$coul eur 


bool imagewbmp 


Envoie une image WBMP vers un navigateur 
ou un fichier. 




resource $image 

[, chaine $filename ] 
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LDAP 



^ Tableau 12.10 : LDAP 


Les fonctions 


Les arguments 


Leur description 


bool ldap add 


Ajoute une entree dans un dossier LDAP. 




resource $link identifier, 
chaine $dn, 
tableau $entry 




bool ldap bind 


Authentification au serveur LDAP avec le RDN et 
le mot de passe specifies. 




resource $link identifier 

[, chaine $bind rdn 

[, chaine $bind password]] 


entier ldap close 


Alias de ldap unbind (). 


| resource $id connexion 




resource ldap connect 


Eta bl it une connexion avec un serveur LDAP. 




[chaine $hostname 
[, entier $port]] 




bool ldap_delete 


Supprime une entree du repertoire. 




ressource $id connexion, 
chaine $dn 




entier ldap errno 


Retourne un numero d'erreur LDAP. 




ressource $id connexion 




chaine ldap error 


Retourne une chaine qui explique I'erreur LDAP 




ressource $id connexion 


generee. 


chaine ldap err2str 


Recupere un numero d'erreur et le transforme en 
chaine. 




entier $errno 


chaine ldap first attribute 


Retourne le premier attribut d'un element. 




resource $id connexion, 
resource $result entry id, 
entier &$ber identifier 
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Tableau 12.10 : LDAP 



ressource 1 dap first entry 


Retourne la premiere entree de I'arbre LDAP. 




ressource $id connexion, 
ressource $result 




ressource ldap first reference 


Retourne la premiere reference de I'arbre LDAP. 




ressource $id connexion, 
ressource $result 


bool ldap free result 


Libere le resultat afin de liberer de la memoire 
RAM. 




ressource $id resultat 


tableau ldap_get_entries 


Retourne sous forme d'un tableau les entrees 
d'un resultat de recherche. 




resource $id connexion, 
resource $id resultat 


bool ldap modify 


Modifie les entrees d'un arbre LDAP. 




ressource $id connexion, 
chaine $dn, 
tableau $entrees 


resource ldap search 


Effectue une recherche dans un arbre LDAP. 




ressource $id connexion, 
chaine $base dn, 
chaine $filtre 
[, tableau $attributs 
[, entier $attrs seuls 
[, entier $taille max 
[, entier $timelimit 
[, entier $deref]]]]] 


bool ldap set option 


Modifie la valeur d'une option LDAP. 




ressource $id connexion, 

entier $option, 

mixte $nouvelle valeur option 
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Tableau 12.11 : MagickWand 


Les fonctions 


Leurs arguments Leur description 


void DrawBezier 


Dessine une courbe de Bezier en utilisant la 
couleur et le style de trait courants. Le tableau 
$poentier doit contenir au minimum six 
nombres (soit les coordonnees de trois points). 




DrawingWand $d, Tableau 
$poentier 


void DrawCircle 


Dessine un cercle sur I'image. 




DrawingWand $d, float 
$centreX, float $centreY, 
float $RayonX, float $RayonY 


void DrawSetFillAlpha 


Definit I'opacite de la couleur de remplissage. 




DrawingWand $d, Float $alpha 


void DrawSetFi 1 1 Col or 


Definit la couleur de remplissage. 




DrawingWand $d, Pixel Wand $p 


void DrawSetStrokeCol or 


Definit la couleur des traits et des contours. 




DrawingWand $d, Pixel Wand $p 


void DrawSetStrokeAl pha 


Definit I'opacite des traits et des contours. 




DrawingWand $d, float $alpha 


void DrawSetStrokeWidth 


Deri nit 1 epaisseur des traits et des contours. 




DrawingWand $d, float 
$epai sseur 


bool Magi ckAddlmage 


Copie I'image $source sur I'image 
$destination. 




DrawingWand $destination, 
DrawingWand $source 


bool Magi ckBl urlmage 


Applique un effet de flou. 




DrawingWand $d, float 
$radius, float $sigma [, 
entier channel type ] 
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bool MagickEchoImageBlob 


Extra it le BLOB {Binary Large OBject) dans 
I'image contenue par $d et I'envoie vers la 
sortie standard qui, sur le Web, devrait etre le 
navigateur de I'utilisateur. 




Drawn ngWand $d 


bool MagickFlattenlmages 


Aplatit la sequence d'image contenue par $d. 




Drawn ngWand $d 


chaTne MagickGetExceptionChaTne 


Renvoie une chaTne de caracteres decrivant les 
erreurs ou exceptions survenues lors de 
I'execution d'une methode de I'API 
MagickWand. 




Drawn ngWand $d 


bool MagickGaussianBlurlmage 


Applique un effet de flou gaussien d l'image. 




DrawingWand $d, float 
$radius, float $sigma [, 
entier $channel type ] 


float MagickGetlmageHeight 


Renvoie la hauteur de l'image. 




DrawingWand $d 


float MagickGetlmageWidth 


Renvoie la largeur de l'image. 




DrawingWand $d 


bool MagickMotionBl urlmage 


Applique un effet de flou directionnel sur 
1 image. 




DrawingWand $d float $radius, 
float $sigma, float $angle 


bool MagickNegatelmage 


L'image passe en negatif. 




DrawingWand $d [, bool 

$1 umi nanceSeul ement [, entier 

channel_type ]] 


bool MagickOi 1 Paenti erlmage 


Applique un effet de peinture d I'huile sur 
1 image. 




DrawingWand $d float $radius 


bool MagickRadial Bl urlmage 


Applique un effet de flou radial d l'image. 




DrawingWand $d, float $angle 
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Tableau 12.11 : MagickWand 



bool Magi ckRai selmage 


Applique un effet dit de biseautage, oi) des 
ombres et des lumieres sont ajoutees d 1 image, 
donnant vaguement I'impression d'un bouton. 




DrawingWand $d, float 
$largeur, float $hauteur, 
entier $x, entier $y, bool 
$raise 


bool Magi ckScal elmage 


Redimensionne I'image. 




DrawingWand $d, float 
$largeur, float $hauteur 


bool MagickSetlmageCompressionQual ity 


Definit le taux de compression de I'image. 




DrawingWand $d, float 
$qual ite 


bool Magi ckSwi rl Image 


Applique un effet tourbillon sur I'image. 




DrawingWand $d, float $degres 


bool MagickWritelmage 


Enregistre I'image sur le disque. 




DrawingWand $d, chaine 
$f i 1 ename 


DrawingWand NewDrawi ngWand 


Cree un objet DrawingWand. 






MagickWand NewMagickWand 


Cree un objet MagickWand. 






PixelWand NewPixelWand 


Cree un objet PixelWand. 




DrawingWand $d, 


bool Pixel SetCol or 


Definit une couleur grace d une chaTne de 
caracteres (exemples : blue, #0000f f , 
"rgb(0,0,255)", "cmyk(100,100,100,10)". 




DrawingWand $d, ChaTne 
$coul eur 



312 



Fonctions des extensions 12 



PDO (PHP Data Object) 




Tableau 12.12 : PDO 



Les fonctions 


Leurs arguments 


Leur description 


PDO construct 


Construit une nouvelle instance permettant la 
connexion au SGBD voulu. Exemple : $oL - 
new pdo($dsn); 




chaine $dsn 

[, chaine $username 

[, chaine $password 

[, tableau $driver options]]] 


entier PD0->exec 


Execute une requete et retourne le nombre de 
lignes affectees. 




chaine $statement 


PDOStatement 


PD0->query 


Execute une requete et retourne un jeu de 
resultats en tant qu'objet PDOStatement. 
Exemple: $qqch = $oL->exec($req sql); 




chaine $statement 


tableau fetchAll 


Retourne sous forme de tableau les resultats de 
la recherche apres execution de query() 
Exemple: $tab = $oL->fetchAl 1 () ; 




[ entier $fetch style 
[, entier $column index]] 


Reflection 


Tableau 12.13 : Reflection 


Les fonctions 


Leurs arguments 


Leur description 



Reflection: : export Affiche un tableau qui contient toute 

I'architecture de la classe $nom_cl asse. 

mixte $nom_classe, 
bool $retour 



chaine ReflectionFunction: :getDocComment Retourne le commentaire associe d la 

fonction sur laquelle est effectuee la 
reflexion. Le commentaire doit respecter le 
formatage PHPDoc. 

entier ReflectionFunction: :getEndLine Retourne le numero de ligne du fichier sur 

laquelle se termine la fonction (accolade 
fermante 1 } 1 ). 
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Tableau 12. 1 3 : Reflection 



chaTne ReflectionFunction: :getFi 1 eName 


Retourne le nom du fichier dans lequel se 
trouve la fonction. 






chaine ReflectionFunction: :getName 


Retourne le nom de la fonction sur laquelle 
est effectuee la reflexion . 






entier 

Ref 1 ecti onFuncti on : :getNumberOf Parameters 


Retourne le nombre de para metres 
(obligatoires et optionnels) necessaires d la 

1 Ul rv II t J 1 1 . 






entier 

Ref 1 ecti onFuncti on : :getNumberOf Requi redParameter 


Retourne le nombre de para metres 
! obligatoires necessaires d la fonction. 






entier ReflectionFunction: :getStartLi ne 


Retourne le numero de ligne du fichier sur 
laquelle commence la definition de la 
fonction. 






tableau ReflectionFunction: :getStaticVariables 


Retourne sous forme de tableau les 
variables de type statique de la fonction sur 
laquelle est effectuee la reflexion. 






bool ReflectionFunction: :isEntierernal 


Determine si une fonction a ete definie par 
un utilisateur (retourne true) ou si celle-ci 
est interne d PHP (retourne false]. 






bool ReflectionFunction: : i sUserDef i ned 


Determine si une fonction est interne d PHP 
(retourne true| ou si celle-ci a ete definie 
par un utilisateur (retourne false). 






public ReflectionClass getDecl ari ngCl ass 


1 cc U 1 1 C 1 CI ICAI Ul 1 oil 1 ILJ LIUooc LJLJ 1 1 o 

laquelle la methode (sur laquelle vous faites 
la reflexion) est definie. 






public bool isAbstract 


Retourne true si la methode est definie en 
tant qu abstraite. 






public bool i sConstructor 


Retourne true si la methode est un 
constructeur. 






public bool isDestructor 


Retourne true si la methode est un 
destructeur. 
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Tableau 12.13 : Reflection 



public bool isFinal 


Retourne true si une methode est definie 
en tcint que finale. 






public bool isPrivate 


Retourne true si une methode a un acces 
prive. 






public bool isProtected 


Retourne true si une methode a un acces 
protege. 






public bool isPublic 


Retourne true si une methode a un acces 
public. 






public bool isStatic 


Retourne true si une methode est definie 
en tant que statique. 







Runkit 




Tableau 12.14 : Runkit 



Les fonctions 


Leurs arguments 


Leur description 


bool runkit class adopt 


Permet d une classe enfant d'heriter d'une 
classe parente. II s agit bien d un heritage 
dynamique. 




chaine $nom classe enfant, 
chaine $nom classe parent 


bool runkit class emancipate 


Permet d une classe parente de se liberer de 
toutes ses classes enfants. 




chaine $nom_cl asse_parent 


bool runkit constant add 


Ajoute dynamiquement une constante. 




chaine $nom constante, 
mixte $valeur 


bool runkit constant redefine 


Redefinit dynamiquement une constante. 




chaine $nom constante, 
mixte $nouvelle valeur 
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Tableau 12.14 : Runkit 



bool runkit constant remove 


Supprime dynamiquement une constante. 




chaine $nom constante 


bool runkit function add 


Ajoute dynamiquement une fonction. 




chaine $nom fonction, 
chaine $liste arguments, 
chaine $code 


bool runkit function redefine 


Redefinit dynamiquement une fonction. 




chaine $nom fonction, 
chaine $liste arguments, 
chaine $code 


bool runkit function remove 


Supprime dynamiquement une fonction. 




chaine $nom fonction 


bool runkit function rename 


Renomme dynamiquement une fonction. 




chaine $nom fonction, 
chaTne $nouveau nom 


bool runkit method add 


Ajoute dynamiquement une methode dans une 
classe. 




chaTne $nom classe, 
chaine $nom methode, 
chaTne $args, chaTne $code 
[, entier $drapeaux] 


bool runkit method redefine 


Redefinit dynamiquement une methode dans 
une classe. 




chaTne $nom classe, 
chaTne $nom methode, 
chaTne $args, chaTne $code 
[, entier $drapeaux] 


bool runkit method remove 


Supprime dynamiquement une methode dans 
une classe. 




chaTne $nom classe, 
chaTne $nom methode 


bool runkit method rename 


Renomme dynamiquement une methode dans 
une classe. 




chaTne $nom_classe, 
chaTne $nom methode, 
chaTne $nouveau nom 
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ZIP 




Tableau 12.15 : ZIP 



Les fonctions 


Leurs arguments 


Leur description 


bool ZipArchive: :addFile 


Ajoute un fichier dans une archive ZIP. 




chaTne $nom fichier 

[, chaine $nom dans archive] 




bool ZipArchive: :addFromChaTne 


Ajoute une chaTne ($contenu) dans un fichier 
($nom dans archive) qui sera place dans 
I'archive ouverte. 




chaine $nom dans archive 
, chaine $contenu 


bool ZipArchive: :close 


Ferme une archive ZIP ouverte via la fonction 
addFile(). 




void 


mixte ZipArchive: :extractTo 


Extrait un ou plusieurs fichiers d'une archive ZIP. 




chaTne $rep dest 
[, mixte $entrees] 




chaTne ZipArchive: :getArchiveComment 


Retourne le commentaire associe d une archive 
ZIP. 






mixte Zi pArchi ve: : 1 ocateName 


Localise I'emplacement d'un fichier dans une 
archive ZIP. 




chaTne $nom fichier 
[, entier $drapeaux] 


mixte ZipArchive: :open 


Ouvre une archive ZIP. 




chaTne nom fichier 
[, entier drapeaux] 




bool ZipArchive: :renamelndex 


Renomme I'index d'un fichier situe dans une 
archive ZIP. 




entier $index, 
chaTne $nouveau nom 


bool ZipArchive: :renameName 


Renomme le nom d'un fichier situe dans une 
archive ZIP. 




chaTne $nom actuel , 
chaTne $nouveau nom 


mixte ZipArchive: :setArchiveComment 


Depose un commentaire associe d une archive 
ZIP. 




chaTne $commentaire 
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ZUB 



^ Tableau 12.16 : ZUB 


Les fonctions 


Les arguments Leur description 


bool gzclose 


Ferme un fichier GZIP ouvert via la fonction 
qzocen () 




ressource $gzo 


chaine gzcompress 


Compresse les donnees selon un taux de 
compression. 




chaine $donnees 

[, entier $taux compression] 


chaine gzdeflate 


Compresse une chaine via une methode qui 
utilise simultanement 1 algorithme LZ77 et le 
codage de Huffman. 




chaine $donnees 
[, entier $niveau] 


chaine gzgetc 


Retourne un caractere des donnees contenues 
dans le fichier ZLIB. 




ressource $zp 


chaine gzgets 


Retourne une chaine de caracteres des donnees 
contenues dans le fichier ZLIB. 




ressource $zp 
, entier $length 


chaine gzgetss 


Retourne une chaine de caracteres des donnees 
contenues dans le fichier ZLIB et en supprimant 
les balises HTML. 




ressource $zp, 
entier $length 
[, chaine $balises permises] 


chaine gzinflate 


Decompresse une chaine compressee via la 
fonction gzdeflate(). 




chaine $data 

[, entier $taille] 


ressource gzopen 


Ouvre un fichier compresse avec I'algorithme 
ZLIB. 




chaine $nom fichier, 
chaine $mode 

[, entier $use include path] 


entier gzpassthru 


Lit les donnees non lues dans un fichier ZLIB. 




resource $zp 



318 



Fonctions des extensions 12 




Tableau 12.16 : ZUB 



chaTne gzread 


Lit le contenu d'un fichier ZLIB. 




ressource $gzo 
, entier $taille 


bool gzrewind 


Place le curseur au debut du fichier ZLIB. 




ressource $gzo 


entier gzseek 


Place le curseur d un endroit precis du fichier 
ZLIB. 




ressource $gzo, 
entier $empl acement 


entier gztell 


Retourne la position d laquelle se trouve le 
curseur dans le fichier ZLIB. 




resource $zp 


chaTne gzuncompress 


Decompresse une chaTne compressee via la 
fonction gzcompress(). 




chaTne $donnees 
[, entier $taille] 


entier gzwrite 


Ecrit dans un fichier ZLIB. 




ressource $gzo, 
chaTne $chaine 
[, entier $taille] 
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